@agala-labs/ui
Select
Selects one or more values from a searchable, collision-aware top-layer listbox.
Examples
Default
Argentina
<AgalaSelect v-model="country" :options="countries" searchable clearable />Import
import { AgalaSelect } from '@agala-labs/ui'API
| Prop | Type | Default | Description |
|---|---|---|---|
options | SelectOption[] | — | Required option collection. |
modelValue | string | string[] | — | Selected value(s). |
multiple | boolean | false | Enables multi-select. |
searchable | boolean | false | Shows filtering input. |
clearable | boolean | false | Allows clearing the selection. |
loading | boolean | false | Shows a loading state. |
size | 'sm' | 'md' | 'lg' | 'md' | Control size. |
placeholder | string | — | Empty selection copy. |
maxDisplayed | number | — | Maximum visible chips. |
maxSelections | number | — | Selection limit. |
error / errorMessage | boolean / string | — | Validation state and copy. |
id / inputId | string | — | ID bound to the combobox trigger. |
name | string | — | Native form field name. |
required | boolean | false | Required state. |
autocomplete | string | — | Native form autocomplete token. |
ariaLabel / ariaLabelledby | string | — | Accessible name or referenced label id. |
ariaDescribedby / ariaDetails / ariaErrorMessage | string | — | Accessible supporting and validation references. |
Events
update:modelValue(value)search(query: string)
Accessibility
Implements combobox/listbox semantics with keyboard navigation, selected state, and expanded state. The option menu is never narrower than its trigger, expands narrow triggers to a legible width, and remains capped by the available viewport.