Skip to content

@agala-labs/ui

Creatable Select

Builds a multi-value selection in a collision-aware top-layer listbox and can create missing options.

Examples

Default
<AgalaCreatableSelect v-model="skills" :options="options" creatable @create="addSkill" />

Import

import { AgalaCreatableSelect } from '@agala-labs/ui'

API

PropTypeDefaultDescription
optionsCreatableSelectOption[]—Required options.
modelValuestring[]—Selected IDs.
creatablebooleantrueAllows new values.
labelKey / idKeystring—Keys used for custom records.
maxDisplayednumber—Maximum visible chips.
debouncenumber—Search debounce in milliseconds.
disabledbooleanfalseDisables interaction.
id / inputIdstring—ID bound to the combobox trigger.
namestring—Native form field name.
requiredbooleanfalseRequired state.
autocompletestring—Native form autocomplete token.
ariaLabel / ariaLabelledbystring—Accessible name or referenced label id.
ariaDescribedby / ariaDetails / ariaErrorMessagestring—Accessible supporting and validation references.

Events

  • update:modelValue(values: string[])
  • create(text: string)
  • search(query: string)

Accessibility

Supports combobox keyboard navigation and announces selected chips through native labels.

Released under the MIT License.