Selection and input
Icon select
A select whose options carry an icon, a label and a description line.
Available
Ports as-is
Examples
Rendered live from the maintained Storybook story. Lantern stores only the story id and embeds Storybook rather than duplicating the component or its demo.
Icon select
Rendered live from Storybook
Storybook must be running for this to load — bun run start:storybook from the monorepo root, or set NEXT_PUBLIC_STORYBOOK_URL to a deployed instance.
Props
The component's public API, read from its TypeScript source. Descriptions come from TSDoc on the prop, so this table cannot drift from the component.
| Prop | Type | Default | Description |
|---|---|---|---|
value | string | — | Undocumented — add TSDoc to the prop in the library. |
onValueChange | (value: string) => void | — | Undocumented — add TSDoc to the prop in the library. |
options* | IconSelectOption[] | — | Undocumented — add TSDoc to the prop in the library. |
placeholder | string | "Select an option" | Undocumented — add TSDoc to the prop in the library. |
className | string | — | Undocumented — add TSDoc to the prop in the library. |
contentClassName | string | — | Undocumented — add TSDoc to the prop in the library. |
open | boolean | — | Open-state passthrough to the underlying Radix Select root. Added for the design system so the portalled listbox can be rendered open on mount in a story (and driven from outside in tests). Omitting all three leaves the component uncontrolled, exactly as before. |
defaultOpen | boolean | — | Undocumented — add TSDoc to the prop in the library. |
onOpenChange | (open: boolean) => void | — | Undocumented — add TSDoc to the prop in the library. |
Reference
Transcribed from the component audit. If this disagrees with the source, the source is right.
- Source
src/components/ui/icon-select.tsx- Portability
- Copies across unchanged — only the utils import path moves.
- States to cover
placeholderselectedopenoption with badgetinted icontruncationscrolling- Dependencies
@radix-ui/react-selectlucide-react- Notes
- Already prop-driven. Uses raw string concatenation rather than cn() — preserved deliberately.