##Polymer.PaperDialogBehavior
Use Polymer.PaperDialogBehavior
and paper-dialog-shared-styles.html
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-shared-styles.html
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. If the user dismisses the dialog with dialog-confirm
, the closingReason
will update to include confirmed: true
.
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 |
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.