third_party/polymer/v1_0/components-chromium/paper-dropdown-menu/README.md

   1 paper-dropdown-menu
   2 ===================
   3
   4 `paper-dropdown-menu` is similar to a native browser select element.
   5 `paper-dropdown-menu` works with selectable content. The currently selected
   6 item is displayed in the control. If no item is selected, the `label` is
   7 displayed instead.
   8 The child element with the class `dropdown-content` will be used as the dropdown
   9 menu. It could be a `paper-menu` or element that triggers `iron-activate` when
  10 selecting its children.
  11 Example:
  12
  13     <paper-dropdown-menu label="Your favourite pastry">
  14       <paper-menu class="dropdown-content">
  15         <paper-item>Croissant</paper-item>
  16         <paper-item>Donut</paper-item>
  17         <paper-item>Financier</paper-item>
  18         <paper-item>Madeleine</paper-item>
  19       </paper-menu>
  20     </paper-dropdown-menu>
  21
  22 This example renders a dropdown menu with 4 options.
  23 ### Styling
  24 The following custom properties and mixins are also available for styling:
  25
  26 Custom property | Description | Default
  27 ----------------|-------------|----------
  28 `--paper-dropdown-menu` | A mixin that is applied to the element host | `{}`
  29 `--paper-dropdown-menu-disabled` | A mixin that is applied to the element host when disabled | `{}`
  30 `--paper-dropdown-menu-ripple` | A mixin that is applied to the internal ripple | `{}`
  31 `--paper-dropdown-menu-button` | A mixin that is applied to the internal menu button | `{}`
  32 `--paper-dropdown-menu-input` | A mixin that is applied to the internal paper input | `{}`
  33 `--paper-dropdown-menu-icon` | A mixin that is applied to the internal icon | `{}`
  34 You can also use any of the `paper-input-container` and `paper-menu-button`
  35 style mixins and custom properties to style the internal input and menu button
  36 respectively.