Elements

组件

选择器 Select

Select:选择器。触发器就是整个控件,列表淡入展开为纸质浮层,选中行使用墨色平铺填充。部件:Root、Label、Control、Trigger、ValueText、Indicator、ClearTrigger、HiddenSelect、Positioner、Content、List、Item、ItemText、ItemIndicator、ItemGroup、ItemGroupLabel。

#基础用法

select/basic Vue React
select/native Vue React

#属性

#ClearTrigger

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

#Content

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

#Control

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

#HiddenSelect

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

#Indicator

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

#ItemContext

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

#ItemGroupLabel

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

#ItemGroup

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

#ItemIndicator

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

#ItemText

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

#Item

属性类型默认值描述
itemT要渲染的选项
persistFocusboolean | undefined悬停移出时是否清除高亮状态

#Label

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

#List

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

#Positioner

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

#Root

属性类型默认值描述
sizeString as PropType<"sm" | "md" | "lg">"md"select 触发器的高度档位
autoCompletestring隐藏 select 的 autocomplete 属性,用于启用浏览器自动填充,例如省州字段用 address-level1
closeOnSelectbooleantrue选中选项后是否关闭 select
collectionListCollection<T>选项集合
compositebooleantrueselect 是否与 tabs、combobox 等复合组件组合使用
defaultHighlightedValuestringselect 打开时高亮项的初始值;不需要控制高亮值时使用
defaultOpenbooleanselect 的打开状态是否受控
defaultValuestring[]select 渲染时的初始默认值;不需要控制 select 值时使用
deselectableboolean是否点击已选项清空值;仅单选模式适用
disabledbooleanselect 是否禁用
formstring底层 select 关联的表单
highlightedValuestring高亮项的受控键值
idstring组件内部状态机的唯一标识
idsPartial<{ root: string; content: string; control: string; trigger: string; clearTrigger: string; label: string; hiddenSelect: string; positioner: string; item(id: string | number): string; itemGroup(id: string | number): string; itemGroupLabel(id: string | number): string; }>select 各元素的 id,适合组合使用
invalidbooleanselect 是否无效
loopFocusbooleanfalse键盘导航是否在选项间循环
modelValuestring[]select 的模型值
multipleboolean是否允许多选
namestring底层 select 的 name 属性
openbooleanselect 菜单是否打开
positioningselect.PositioningOptions菜单的定位选项
readOnlybooleanselect 是否只读
requiredbooleanselect 是否必填
scrollToIndexFn(details: select.ScrollToIndexDetails) => void滚动到指定索引的函数
translationsselect.IntlTranslations无障碍元素及其状态的本地化文案

#Trigger

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

#ValueText

属性类型默认值描述
placeholderstring—