# @npm-polymer/iron-dropdown

> An unstyled element that works similarly to a native browser select

Latest version **2.0.0** (published 2017-06-03) · http://polymer.github.io/LICENSE.txt license · 0 weekly downloads

> **Deprecated.** This package is deprecated.

## Install

```sh
npm install @npm-polymer/iron-dropdown
pnpm add @npm-polymer/iron-dropdown
yarn add @npm-polymer/iron-dropdown
bun add @npm-polymer/iron-dropdown
```

## Health

**Score 10/100 (F)** — status: deprecated.

Negative: deprecated.

## Facts

| | |
|---|---|
| Version | 2.0.0 |
| Published | 2017-06-03 |
| First published | 2017-06-03 |
| Weekly downloads | 0 |
| License | http://polymer.github.io/LICENSE.txt |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 4 |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 34 |
| Maintainers | npm-polymer |
| Keywords | web-components, web-component, polymer |

## Links

- npm: https://www.npmjs.com/package/@npm-polymer/iron-dropdown
- Repository: https://github.com/PolymerElements/iron-dropdown
- Issues: https://github.com/PolymerElements/iron-dropdown/issues
- npm.io page: https://npm.io/package/@npm-polymer/iron-dropdown

## Dependencies (4)

- [@npm-polymer/polymer](https://npm.io/package/@npm-polymer/polymer.md) 2.0.1
- [@npm-polymer/iron-behaviors](https://npm.io/package/@npm-polymer/iron-behaviors.md) 1.0.18
- [@npm-polymer/neon-animation](https://npm.io/package/@npm-polymer/neon-animation.md) 2.0.0
- [@npm-polymer/iron-overlay-behavior](https://npm.io/package/@npm-polymer/iron-overlay-behavior.md) 2.0.0

## Recent versions

- 2.0.0 (latest) — 2017-06-03

## README

[![Build status](https://travis-ci.org/PolymerElements/iron-dropdown.svg?branch=master)](https://travis-ci.org/PolymerElements/iron-dropdown)

_[Demo and API docs](https://elements.polymer-project.org/elements/iron-dropdown)_


## <iron-dropdown>

`<iron-dropdown>` is a generalized element that is useful when you have
hidden content (`dropdown-content`) that is revealed due to some change in
state that should cause it to do so.

Note that this is a low-level element intended to be used as part of other
composite elements that cause dropdowns to be revealed.

Examples of elements that might be implemented using an `iron-dropdown`
include comboboxes, menubuttons, selects. The list goes on.

The `<iron-dropdown>` element exposes attributes that allow the position
of the `dropdown-content` relative to the `dropdown-trigger` to be
configured.

```html
<iron-dropdown horizontal-align="right" vertical-align="top">
  <div slot="dropdown-content">Hello!</div>
</iron-dropdown>
```

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.

### Changes in 2.0
- Removed the private property `_focusTarget` which was deprecated.
- `neon-animation 2.0` doesn't import the Web Animations polyfill, so you'll have to import it ([see example](demo/index.html))

---
_Source: https://npm.io/package/@npm-polymer/iron-dropdown · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._