Combobox
Combobox combines free-form text entry with option picking, making it useful for searchable single- and multi-select flows.
Props
| Name | Description | Default | Control |
|---|---|---|---|
disabledOptional | Whether the control is disabled. boolean | undefined | - | |
nameOptional | Name used for hidden inputs during form submission. string | undefined | - | |
multipleOptional | Enables multi-select behavior. boolean | undefined | - | - |
labelOptional | Visible label. If omitted, provide aria-label via attrs. string | undefined | - | |
idOptional | Optional explicit id for the trigger element. string | undefined | - | |
optionsRequired | Selectable options rendered in the menu. SelectOption[] | - | - |
descriptionOptional | Supporting text shown below the field when not in error state. string | undefined | - | |
errorOptional | Error text shown below the field. When provided, field is invalid. string | undefined | - | |
requiredOptional | Whether the control is required. boolean | undefined | - | |
placeholderOptional | Placeholder shown when nothing is selected. string | undefined | - | |
menuColorOptional | Visual color style of the dropdown menu. MenuColor | undefined | - | - |
displaySeparatorOptional | Separator used when showing multiple selected labels. string | undefined | - | |
filterPlaceholderOptional | Placeholder shown in the menu filter field. string | undefined | - | |
filterNoResultsTextOptional | Message shown when filtering returns no matching options. string | undefined | - | |
modelValueOptional | - SelectModelValue | - | - |
openOptional | - boolean | undefined | false |
Events
| Name | Type | Description |
|---|---|---|
update:modelValue | [value: SelectModelValue] | - |
update:open | [value: boolean] | - |
change | [value: SelectModelValue] | - |
focus | [event: FocusEvent] | - |
blur | [event: FocusEvent] | - |
Slots
| Name | Parameters | Description |
|---|---|---|
leading | - | - |
prefix | - | - |
suffix | - | - |
trailing | - | - |
optionLeading | - | - |
optionTrailing | - | - |