1# Listbox
2 
3Accessible list selection
4 
5**Parts:** `ListboxRoot`, `ListboxContent`, `ListboxFilter`, `ListboxItem`, `ListboxItemIndicator`, `ListboxGroup`, `ListboxGroupLabel`, `ListboxVirtualizer`
6 
7## ListboxRoot
8 
9### Props
10| Prop | Type | Default |
11|------|------|---------|
12| `as` | `AsTag \| Component` | `"div"` |
13| `asChild` | `boolean` | - |
14| `by` | `string \| ((a: AcceptableValue, b: AcceptableVal...` | - |
15| `defaultValue` | `AcceptableValue \| AcceptableValue[]` | - |
16| `dir` | `"ltr" \| "rtl"` | - |
17| `disabled` | `boolean` | - |
18| `highlightOnHover` | `boolean` | - |
19| `modelValue` | `AcceptableValue \| AcceptableValue[]` | - |
20| `multiple` | `boolean` | - |
21| `name` | `string` | - |
22| `orientation` | `"vertical" \| "horizontal"` | `"vertical"` |
23| `selectionBehavior` | `"toggle" \| "replace"` | `"toggle"` |
24 
25### Emits
26| Event | Payload |
27|-------|---------|
28| `entryFocus` | `[event: CustomEvent<any>]` |
29| `highlight` | `[payload: { ref: HTMLElement; value: Acceptable...` |
30| `leave` | `[event: Event]` |
31| `update:modelValue` | `[value: AcceptableValue]` |
32 
33### Slots
34| Slot | Type |
35|------|------|
36| `modelValue` | `AcceptableValue \| AcceptableValue[] \| undefined` |
37 
38## ListboxContent
39 
40### Props
41| Prop | Type | Default |
42|------|------|---------|
43| `as` | `AsTag \| Component` | `"div"` |
44| `asChild` | `boolean` | - |
45 
46## ListboxFilter
47 
48### Props
49| Prop | Type | Default |
50|------|------|---------|
51| `as` | `AsTag \| Component` | `"input"` |
52| `asChild` | `boolean` | - |
53| `autoFocus` | `boolean` | - |
54| `modelValue` | `string` | - |
55 
56### Emits
57| Event | Payload |
58|-------|---------|
59| `update:modelValue` | `[string]` |
60 
61### Slots
62| Slot | Type |
63|------|------|
64| `modelValue` | `string \| undefined` |
65 
66## ListboxItem
67 
68### Props
69| Prop | Type | Default |
70|------|------|---------|
71| `as` | `AsTag \| Component` | `"div"` |
72| `asChild` | `boolean` | - |
73| `disabled` | `boolean` | - |
74| `value`* | `AcceptableValue` | - |
75 
76### Emits
77| Event | Payload |
78|-------|---------|
79| `select` | `[event: SelectEvent<AcceptableValue>]` |
80 
81## ListboxItemIndicator
82 
83### Props
84| Prop | Type | Default |
85|------|------|---------|
86| `as` | `AsTag \| Component` | `"span"` |
87| `asChild` | `boolean` | - |
88 
89## ListboxGroup
90 
91### Props
92| Prop | Type | Default |
93|------|------|---------|
94| `as` | `AsTag \| Component` | `"div"` |
95| `asChild` | `boolean` | - |
96 
97## ListboxGroupLabel
98 
99### Props
100| Prop | Type | Default |
101|------|------|---------|
102| `as` | `AsTag \| Component` | `"div"` |
103| `asChild` | `boolean` | - |
104| `for` | `string` | - |
105 
106## ListboxVirtualizer
107 
108### Props
109| Prop | Type | Default |
110|------|------|---------|
111| `estimateSize` | `number` | - |
112| `options`* | `AcceptableValue[]` | - |
113| `textContent` | `((option: AcceptableValue) => string)` | - |
114 
115### Slots
116| Slot | Type |
117|------|------|
118| `option` | `string \| number \| false \| true \| Record<string,...` |
119| `virtualizer` | `Virtualizer<Element \| Window, Element>` |
120| `virtualItem` | `VirtualItem<Element>` |
121