##<paper-dropdown-menu>
Material design: Dropdown menus
paper-dropdown-menu
is similar to a native browser select element.
paper-dropdown-menu
works with selectable content. The currently selected
item is displayed in the control. If no item is selected, the label
is
displayed instead.
The child element with the class dropdown-content
will be used as the dropdown
menu. It could be a paper-menu
or element that triggers iron-select
when
selecting its children.
Example:
<paper-dropdown-menu label="Your favourite pastry">
<paper-menu class="dropdown-content">
<paper-item>Croissant</paper-item>
<paper-item>Donut</paper-item>
<paper-item>Financier</paper-item>
<paper-item>Madeleine</paper-item>
</paper-menu>
</paper-dropdown-menu>
This example renders a dropdown menu with 4 options.
Similarly to using iron-select
, iron-deselect
events will cause the
current selection of the paper-dropdown-menu
to be cleared.
The following custom properties and mixins are also available for styling:
Custom property | Description | Default |
---|---|---|
--paper-dropdown-menu |
A mixin that is applied to the element host | {} |
--paper-dropdown-menu-disabled |
A mixin that is applied to the element host when disabled | {} |
--paper-dropdown-menu-ripple |
A mixin that is applied to the internal ripple | {} |
--paper-dropdown-menu-button |
A mixin that is applied to the internal menu button | {} |
--paper-dropdown-menu-input |
A mixin that is applied to the internal paper input | {} |
--paper-dropdown-menu-icon |
A mixin that is applied to the internal icon | {} |
You can also use any of the paper-input-container
and paper-menu-button
style mixins and custom properties to style the internal input and menu button
respectively.