Skip to content
An unstyled element that works similarly to a native browser select
HTML JavaScript
Branch: master
Clone or download
This branch is 2 commits behind PolymerElements:master.

Latest commit

Fetching latest commit…
Cannot retrieve the latest commit at this time.

Files

Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github
demo
test
.gitignore
.npmignore
.travis.yml
CONTRIBUTING.md
README.md
bower.json
formatconfig.json
iron-dropdown-scroll-manager.js
iron-dropdown.js
manifest.json
package-lock.json
package.json
wct.conf.json

README.md

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
You can’t perform that action at this time.