列表框 Listbox

Label · Input · Item · ItemText · ItemIndicator · ItemGroup · ItemGroupLabel · Content · Root · ValueText

#Content

纯造型的部件——自身没有属性，沿用部件结构的共享样式。

纯造型的部件——自身没有属性，沿用部件结构的共享样式。

属性	类型	默认值	描述
`autoHighlight`	`boolean \| undefined`	`false`	输入时是否自动高亮选项
`keyboardPriority`	`"caret" \| "navigate" \| undefined`	`"caret"`	输入框键盘事件的优先级：`caret` 保留原生文本编辑行为，`navigate` 把支持的按键转发给列表框导航

纯造型的部件——自身没有属性，沿用部件结构的共享样式。

纯造型的部件——自身没有属性，沿用部件结构的共享样式。

纯造型的部件——自身没有属性，沿用部件结构的共享样式。

纯造型的部件——自身没有属性，沿用部件结构的共享样式。

纯造型的部件——自身没有属性，沿用部件结构的共享样式。

属性	类型	默认值	描述
`highlightOnHover`	`boolean \| undefined`		悬停时是否高亮选项
`item`	`T`		要渲染的列表选项

纯造型的部件——自身没有属性，沿用部件结构的共享样式。

属性	类型	默认值	描述
`size`	`String as PropType<"sm" \| "md" \| "lg">`	`"md"`	行和筛选字段使用的尺寸档位
`collection`	`ListCollection<T>`		选项集合
`defaultHighlightedValue`	`string`		打开时默认高亮项的值；适合不需要受控高亮值的场景
`defaultValue`	`string[]`	`[]`	列表框的初始默认值；适合不需要受控值的场景
`deselectable`	`boolean`		是否禁止空选择
`disabled`	`boolean`		是否禁用列表框
`disallowSelectAll`	`boolean`		按下 `meta+a` 时是否禁止全选
`highlightedValue`	`string`		高亮项的受控值
`id`	`string`		组件内部状态机的唯一标识
`ids`	`Partial<{ root: string; content: string; label: string; item(id: string \| number): string; itemGroup(id: string \| number): string; itemGroupLabel(id: string \| number): string; }>`		列表框各元素的 id，便于组合使用
`loopFocus`	`boolean`	`false`	键盘导航是否在选项间循环
`modelValue`	`string[]`		列表框的模型值
`orientation`	`'horizontal' \| 'vertical'`	`"horizontal"`	列表框的排列方向
`scrollToIndexFn`	`(details: listbox.ScrollToIndexDetails) => void`		滚动到指定索引的函数
`selectionMode`	`listbox.SelectionMode`	`"single"`	列表框的选择行为：`single` 只能选择一个选项，`multiple` 不按修饰键也能选择多个，`extended` 需要配合修饰键选择多个
`selectOnHighlight`	`boolean`		选项高亮时是否选中
`typeahead`	`boolean`		是否启用输入即查找

事件	载荷
`select`	`details: SelectionDetails`
`valueChange`	`details: ValueChangeDetails<T>`
`update:modelValue`	`value: string[]`
`highlightChange`	`details: HighlightChangeDetails<T>`
`update:highlightedValue`	`value: string \| null`

属性	类型	默认值	描述
`placeholder`	`string`		—