@aria-ui/listbox

ListboxEvents #

valueChange

Type: CustomEvent<string>

ListboxItemProps #

value

The value of the item. Every item must have a unique value in the parent list.

Type: string

Default: ""

ListboxProps #

autoFocus

Whether the listbox should automatically set the focus to the first item when the listbox is mounted or when the query changes.

Type: boolean

Default: false

eventTarget

By default, the Listbox element will listen for keydown events. You can pass a different element to listen for keydown events.

Type: HTMLElement | TypedEventTarget<"keydown">

filter

The filter function to determine if an item should be shown in the listbox. By default, a simple case-insensitive substring match is used. You can provide a custom filter function to match against a more complex pattern. You can also pass null to disable filtering and allow all items to be shown.

Type: null | ItemFilter

Default: defaultItemFilter

query

The query string to filter the listbox items.

Type: string

Default: ""

selectionMode

Listbox selection mode

(Currently only single selection mode is implemented)

Type: "multiple" | "single"

Default: "single"

value

The selected value.

Type: string

Default: ""