# @igloo-ui/dropdown

> Displays a sub-element overlaid and renders the content

Latest version **2.1.0** (published 2026-03-24) · Apache-2.0 license · 0 weekly downloads

## Install

```sh
npm install @igloo-ui/dropdown
pnpm add @igloo-ui/dropdown
yarn add @igloo-ui/dropdown
bun add @igloo-ui/dropdown
```

## Health

**Score 55/100 (C)** — status: stable.

Positive: has types; esm support; no vulnerabilities.

Warnings: low downloads.

## Facts

| | |
|---|---|
| Version | 2.1.0 |
| Published | 2026-03-24 |
| First published | 2022-11-11 |
| Weekly downloads | 0 |
| License | Apache-2.0 |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Dependencies | 4 |
| Unpacked size | 29.9 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 23 |
| Author | Officevibe Inc. |
| Maintainers | infra.admin, alexasselin008 |

## Links

- npm: https://www.npmjs.com/package/@igloo-ui/dropdown
- Repository: https://github.com/workleap/ov-igloo-ui
- Homepage: https://github.com/workleap/ov-igloo-ui#readme
- Issues: https://github.com/workleap/ov-igloo-ui/issues
- npm.io page: https://npm.io/package/@igloo-ui/dropdown

## Dependencies (4)

- [classnames](https://npm.io/package/classnames.md) ^2.5.1
- [@igloo-ui/tokens](https://npm.io/package/@igloo-ui/tokens.md) ^2.1.0
- [@hopper-ui/tokens](https://npm.io/package/@hopper-ui/tokens.md) ^5.0.0
- [@floating-ui/react](https://npm.io/package/@floating-ui/react.md) ^0.27.3

## Recent versions

- 2.1.0 (latest) — 2026-03-24
- 2.0.3 — 2026-03-11
- 2.0.2 — 2025-08-08
- 2.0.1 — 2025-07-23
- 2.0.0 — 2025-07-22
- 1.9.3 — 2025-01-22
- 1.9.2 — 2024-08-09
- 1.9.1 — 2024-08-01
- 1.9.0 — 2024-05-27
- 1.8.3 — 2024-05-17
- 1.8.2 — 2024-05-02
- 1.8.1 — 2024-02-23
- 1.8.0 — 2024-01-23
- 1.7.1 — 2024-01-19
- 1.7.0 — 2024-01-17
- … 23 more at https://npm.io/package/@igloo-ui/dropdown/versions

## README

# Dropdown

Displays a sub-element overlaid and renders the content

<Example is="custom" />

<ReferenceLinks is="custom" />

## Installation

To install `@igloo-ui/dropdown` in your project, you will need to run the following command using [npm](https://www.npmjs.com/):

```bash
npm install @igloo-ui/dropdown
```

If you prefer [Yarn](https://classic.yarnpkg.com/en/), use the following command instead:

```bash
yarn add @igloo-ui/dropdown
```

## Usage

Then to use the component in your code just import it!

```jsx
import Dropdown from '@igloo-ui/dropdown';
import Button from '@igloo-ui/button';

const [show, setShow] = React.useState(false);

function List() {
  const listItem = items.map((item, key) => (
    <li key={`list-item_${key}`}>{item}</li>
  ));
  return <ul>{listItem}</ul>;
}

<Dropdown isOpen={show} onClose={() => setShow(false)} content={<List />}>
  <Button appearance="secondary" size="small" onClick={() => setShow(!show)}>
    Settings
  </Button>
</Dropdown>;
```

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