| Index: third_party/polymer/v1_0/components-chromium/paper-dialog-behavior/README.md
|
| diff --git a/third_party/polymer/v1_0/components-chromium/paper-dialog-behavior/README.md b/third_party/polymer/v1_0/components-chromium/paper-dialog-behavior/README.md
|
| index 2c63d3cdaadab1972a6d74c28a5abae0ca884d33..af0983d677b3dd15620c07ecd2eaf5f279d4aa99 100644
|
| --- a/third_party/polymer/v1_0/components-chromium/paper-dialog-behavior/README.md
|
| +++ b/third_party/polymer/v1_0/components-chromium/paper-dialog-behavior/README.md
|
| @@ -1,24 +1,64 @@
|
| -# paper-dialog-behavior
|
|
|
| -`paper-dialog-behavior` implements behavior related to a Material Design dialog. Use this behavior
|
| -and include `paper-dialog-common.css` in your element to implement a dialog.
|
| +<!---
|
| +
|
| +This README is automatically generated from the comments in these files:
|
| +paper-dialog-behavior.html
|
| +
|
| +Edit those files, and our readme bot will duplicate them over here!
|
| +Edit this file, and the bot will squash your changes :)
|
| +
|
| +-->
|
| +
|
| +[](https://travis-ci.org/PolymerElements/paper-dialog-behavior)
|
| +
|
| +_[Demo and API Docs](https://elements.polymer-project.org/elements/paper-dialog-behavior)_
|
| +
|
| +
|
| +##Polymer.PaperDialogBehavior
|
| +
|
| +
|
| +Use `Polymer.PaperDialogBehavior` and `paper-dialog-common.css` to implement a Material Design
|
| +dialog.
|
| +
|
| +For example, if `<paper-dialog-impl>` implements this behavior:
|
| +
|
| + <paper-dialog-impl>
|
| + <h2>Header</h2>
|
| + <div>Dialog body</div>
|
| + <div class="buttons">
|
| + <paper-button dialog-dismiss>Cancel</paper-button>
|
| + <paper-button dialog-confirm>Accept</paper-button>
|
| + </div>
|
| + </paper-dialog-impl>
|
|
|
| `paper-dialog-common.css` provide styles for a header, content area, and an action area for buttons.
|
| Use the `<h2>` tag for the header and the `buttons` class for the action area. You can use the
|
| `paper-dialog-scrollable` element (in its own repository) if you need a scrolling content area.
|
|
|
| Use the `dialog-dismiss` and `dialog-confirm` attributes on interactive controls to close the
|
| -dialog.
|
| +dialog. If the user dismisses the dialog with `dialog-confirm`, the `closingReason` will update
|
| +to include `confirmed: true`.
|
| +
|
| +### Styling
|
| +
|
| +The following custom properties and mixins are available for styling.
|
| +
|
| +Custom property | Description | Default
|
| +----------------|-------------|----------
|
| +`--paper-dialog-background-color` | Dialog background color | `--primary-background-color`
|
| +`--paper-dialog-color` | Dialog foreground color | `--primary-text-color`
|
| +`--paper-dialog` | Mixin applied to the dialog | `{}`
|
| +`--paper-dialog-title` | Mixin applied to the title (`<h2>`) element | `{}`
|
| +`--paper-dialog-button-color` | Button area foreground color | `--default-primary-color`
|
| +
|
| +### Accessibility
|
| +
|
| +This element has `role="dialog"` by default. Depending on the context, it may be more appropriate
|
| +to override this attribute with `role="alertdialog"`.
|
| +
|
| +If `modal` is set, the element will set `aria-modal` and prevent the focus from exiting the element.
|
| +It will also ensure that focus remains in the dialog.
|
| +
|
| +The `aria-labelledby` attribute will be set to the header element, if one exists.
|
|
|
| -For example, if `<paper-dialog-impl>` implements this behavior:
|
|
|
| -```html
|
| -<paper-dialog-impl>
|
| - <h2>Header</h2>
|
| - <div>Dialog body</div>
|
| - <div class="buttons">
|
| - <paper-button dialog-dismiss>Cancel</paper-button>
|
| - <paper-button dialog-confirm>Accept</paper-button>
|
| - </div>
|
| -</paper-dialog-impl>
|
| -```
|
|
|