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> |
-``` |