Select

Select provides an anchored menu for choosing one or many options, with optional icons, filtering, and validation text.

Props

NameDescriptionDefaultControl
labelOptional

Visible label. If omitted, provide aria-label via attrs.

string | undefined
undefined
idOptional

Optional explicit id for the trigger element.

string | undefined
undefined
optionsRequired

Selectable options rendered in the menu.

SelectOption[]
-
-
descriptionOptional

Supporting text shown below the field when not in error state.

string | undefined
undefined
errorOptional

Error text shown below the field. When provided, field is invalid.

string | undefined
undefined
disabledOptional

Whether the control is disabled.

boolean | undefined
false
requiredOptional

Whether the control is required.

boolean | undefined
false
nameOptional

Name used for hidden inputs during form submission.

string | undefined
undefined
placeholderOptional

Placeholder shown when nothing is selected.

string | undefined
undefined
multipleOptional

Enables multi-select behavior.

boolean | undefined
false
-
menuColorOptional

Visual color style of the dropdown menu.

MenuColor | undefined
"standard"
-
displaySeparatorOptional

Separator used when showing multiple selected labels.

string | undefined
", "
filterableOptional

Enables a filter field inside the menu to narrow long option lists.

boolean | undefined
false
filterPlaceholderOptional

Placeholder shown in the menu filter field.

string | undefined
"Filter options"
filterNoResultsTextOptional

Message shown when filtering returns no matching options.

string | undefined
"No matching options"
modelValueOptional

-

SelectModelValue
-
-
openOptional

-

boolean | undefined
false

Events

NameTypeDescription
update:modelValue[value: SelectModelValue]-
update:open[value: boolean]-
change[value: SelectModelValue]-
focus[event: FocusEvent]-
blur[event: FocusEvent]-

Slots

NameParametersDescription
leading--
prefix--
suffix--
trailing--
optionLeading--
optionTrailing--

Default

Without Icons

Filtering

Configurations