Newfangled Package Modernizer

    @polymer/iron-dropdown
    TypeScript icon, indicating that this package has built-in type declarations

    3.0.1 • Public • Published

    Published on NPM Build status Published on webcomponents.org

    <iron-dropdown>

    <iron-dropdown> displays content inside a fixed-position container, positioned relative to another element.

    See: Documentation, Demo.

    Usage

    Installation

    npm install --save @polymer/iron-dropdown
    

    In an HTML file

    <html>
      <head>
        <script type="module">
          import '@polymer/iron-dropdown/iron-dropdown.js';
        </script>
        <style>
          #container {
            display: inline-block;
          }
    
          iron-dropdown {
            border: 1px solid gray;
            background: white;
            font-size: 2em;
          }
        </style>
      </head>
      <body>
        <div id="container">
          <button onclick="dropdown.open();">open the iron-dropdown</button>
          <iron-dropdown id="dropdown" no-overlap>
            <div slot="dropdown-content">Hello!</div>
          </iron-dropdown>
        </div>
      </body>
    </html>

    In a Polymer 3 element

    import {PolymerElement, html} from '@polymer/polymer';
    import '@polymer/iron-dropdown/iron-dropdown.js';
    
    class SampleElement extends PolymerElement {
      static get template() {
        return html`
          <style>
            :host {
              display: inline-block;
            }
    
            iron-dropdown {
              border: 1px solid gray;
              background: white;
              font-size: 2em;
            }
          </style>
          <button on-click="_openDropdown">open the dropdown</button>
          <iron-dropdown id="dropdown" horizontal-align="right" vertical-align="top">
            <div slot="dropdown-content">Hello!</div>
          </iron-dropdown>
        `;
      }
    
      _openDropdown() {
        this.$.dropdown.open();
      }
    }
    customElements.define('sample-element', SampleElement);

    In the above example, the <div> assigned to the dropdown-content slot will be hidden until the dropdown element has opened set to true, or when the open method is called on the element.

    Contributing

    If you want to send a PR to this element, here are the instructions for running the tests and demo locally:

    Installation

    git clone https://github.com/PolymerElements/iron-dropdown
    cd iron-dropdown
    npm install
    npm install -g polymer-cli

    Running the demo locally

    polymer serve --npm
    open http://127.0.0.1:<port>/demo/

    Running the tests

    polymer test --npm

    Install

    npm i @polymer/iron-dropdown

    DownloadsWeekly Downloads

    10,869

    Version

    3.0.1

    License

    BSD-3-Clause

    Unpacked Size

    49.1 kB

    Total Files

    13

    Last publish

    Collaborators

    • aomarks
    • emarquez
    • sorvell
    • bicknellr
    • usergenic
    • polymer-devs
    • azakus
    • kevinpschaaf
    • justinfagnani