Skip to content

Select

Dropdown select with single / multi / tag / searchable modes. Replaces the old EpDropdown and EpSearchDropdown.

Single

Example

Multiple

Searchable

Tags (free-text entries)

API

Props

NameTypeDefaultDescription
valueSelectValuenull
optionsArray() => []
labelstring""
placeholderstring"Select"
searchPlaceholderstring""
multiplebooleanfalse
tagsbooleanfalse
allowClearbooleanfalse
showSearchbooleanfalse
loadingbooleanfalse
disabledbooleanfalse
borderedbooleantrue
stateDataEntryState"default"
sizeEpSizeundefined
assistiveTextstring""
alertMessagestring""
ariaLabelstring""
listMaxHeightnumber240
optionHeightnumber32
notFoundTextstring"No options"
loadingTextstring"Loading…"
clearLabelstring"Clear"
createLabelstring"Create"
searchAriaLabelstring"Search options"
filterunionnull

Events

EventPayloadDescription
update:value{"names":["SelectValue"]}
change{"names":["SelectValue"]}
search{"names":["string"]}
clear
open
close
focus{"names":["FocusEvent"]}
blur{"names":["FocusEvent"]}

Slots

This component has no named slots.

Released under the MIT License. Built with VitePress.