Multi Select
A searchable multi-select dropdown with badge display, groups, and creatable options.
Usage
With Groups & Creatable
Use groups for organized options, creatable to allow new values, and maxDisplay to limit visible badges.
Props
| Prop | Type | Default | Description |
|---|---|---|---|
modelValue | string[] | - | The selected values (v-model). |
options | { label: string; value: string }[] | - | Flat list of selectable options. |
groups | { label: string; options: { label: string; value: string }[] }[] | - | Grouped options displayed under section headings. |
placeholder | string | 'Select...' | Placeholder text when nothing is selected. |
searchPlaceholder | string | 'Search...' | Placeholder for the search input inside the dropdown. |
emptyText | string | 'No results found' | Text shown when no options match the search query. |
maxDisplay | number | - | Maximum number of badges to display before showing a count. |
max | number | - | Maximum number of items that can be selected. |
disabled | boolean | false | Disables the entire select. |
creatable | boolean | false | Allow creating new options from the search input. |