> ## Documentation Index
> Fetch the complete documentation index at: https://docs.equa.cc/llms.txt
> Use this file to discover all available pages before exploring further.

# EquaDropdown

> Design system reference for EquaDropdown, including Storybook, Figma, screenshots, and usage guidance

# EquaDropdown

> **Last Verified:** 2026-05-20 | **Storybook source:** `equa-patternlib-nextjs/stories/EquaDropdown.stories.tsx`, Line: 6

## Purpose

Option menus, selects, and compact menu surfaces.

## Storybook

| Story                 | Reference                                                                            |
| --------------------- | ------------------------------------------------------------------------------------ |
| Default               | [Storybook](http://localhost:6006/?path=/story/equa-dropdown--default)               |
| Controlled            | [Storybook](http://localhost:6006/?path=/story/equa-dropdown--controlled)            |
| With Label            | [Storybook](http://localhost:6006/?path=/story/equa-dropdown--with-label)            |
| With Preselected      | [Storybook](http://localhost:6006/?path=/story/equa-dropdown--with-preselected)      |
| Disabled              | [Storybook](http://localhost:6006/?path=/story/equa-dropdown--disabled)              |
| With Error            | [Storybook](http://localhost:6006/?path=/story/equa-dropdown--with-error)            |
| With Disabled Options | [Storybook](http://localhost:6006/?path=/story/equa-dropdown--with-disabled-options) |
| Full Width            | [Storybook](http://localhost:6006/?path=/story/equa-dropdown--full-width)            |
| Transfer Example      | [Storybook](http://localhost:6006/?path=/story/equa-dropdown--transfer-example)      |
| Form Example          | [Storybook](http://localhost:6006/?path=/story/equa-dropdown--form-example)          |
| All States            | [Storybook](http://localhost:6006/?path=/story/equa-dropdown--all-states)            |

## API And Props

| Prop or Control | Source            | Notes                                |
| --------------- | ----------------- | ------------------------------------ |
| `disabled`      | Storybook control | See source story for accepted values |
| `error`         | Storybook control | See source story for accepted values |
| `fullWidth`     | Storybook control | See source story for accepted values |
| `placeholder`   | Storybook control | See source story for accepted values |
| `label`         | Storybook control | See source story for accepted values |

Sources:

* `equa-patternlib-nextjs/src/components/dropdown/dropdown.tsx`, Line: 5
* `equa-patternlib-nextjs/src/components/dropdown/index.ts`
* `equa-patternlib-nextjs/stories/EquaDropdown.stories.tsx`, Line: 6

## Figma

UNVERIFIED -- requires Figma node assignment

## Screenshots

| State           | Asset                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| --------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Equa dark theme | <img src="https://mintcdn.com/equainc/WF4vvyO1PBrsp7n_/images/design-system/components/equa-dropdown/equa-dropdown--default-equa.png?fit=max&auto=format&n=WF4vvyO1PBrsp7n_&q=85&s=3eff3ed73fd1cb5efa717944454bcded" alt="EquaDropdown dark theme" width="1366" height="900" data-path="images/design-system/components/equa-dropdown/equa-dropdown--default-equa.png" />          |
| Light theme     | <img src="https://mintcdn.com/equainc/WF4vvyO1PBrsp7n_/images/design-system/components/equa-dropdown/equa-dropdown--default-light.png?fit=max&auto=format&n=WF4vvyO1PBrsp7n_&q=85&s=d8f3d7359cdec9653407bc95b0f3e365" alt="EquaDropdown light theme" width="1366" height="900" data-path="images/design-system/components/equa-dropdown/equa-dropdown--default-light.png" /> |

## Usage Notes

* Prefer this component over local one-off UI for matching product states.
* Keep new variants represented in Storybook before adding docs references here.
* Use token-backed colors, spacing, radius, and shadows from [Foundations](/architecture/design-system/foundations).

## Accessibility Notes

* Preserve keyboard and focus behavior from the source component.
* Any icon-only controls must provide an accessible label in consuming product code.
* Validate color contrast in both Equa dark and light theme screenshots before release.
