Multi Select
A combobox that lets the user pick several options at once. Selected items appear as removable badges in the trigger, and the dropdown supports inline search with keyboard navigation.
Installation
Props
| Prop | Type | Default | Description |
|---|---|---|---|
options* | { value: string; label: string }[] | — | List of selectable options. |
value | string[] | — | Controlled list of selected option values. |
onChange | (value: string[]) => void | — | Called whenever the selection changes. |
placeholder | string | "Select options..." | Trigger placeholder when nothing is selected. |
searchPlaceholder | string | "Search..." | Placeholder for the inline search field. |
emptyMessage | string | "No results found." | Shown when the search returns nothing. |
maxDisplayedItems | number | 4 | Max number of selected badges before "+N" overflow. |
disabled | boolean | false | Disable the trigger. |