Select
组合式选择器运行时：Root 持有 value/open，Trigger/Value/Content/Item 分工渲染。
运行时
状态契约由 @varo-ui/headless 提供；渲染 Parts 分别来自 @varo-ui/h5/primitives 与 @varo-ui/weapp/primitives。
演示
基础用法
通过上方演示面板切换 H5 与 Weapp primitive 预览/代码；每个运行时只渲染当前条目。
分组、只读与禁用
分组用 SelectGroup/SelectLabel。readonly 状态下组件仍可打开、关闭和浏览选项，但 SelectItem 和 setValue 不会更改 value；disabled 连打开操作也会阻止。定位与动画交给 UI wrapper。
Parts
| Part | 作用 |
|---|---|
SelectRoot | value/open 状态 |
SelectTrigger | 打开入口 |
SelectValue | 当前值展示 |
SelectContent | 选项容器 |
SelectGroup | 分组 |
SelectLabel | 分组标题 |
SelectItem | 单个选项 |
Props
SelectRoot
| Prop | 类型 | 默认值 | 描述 |
|---|---|---|---|
value | unknown | undefined | 受控值 |
defaultValue | unknown | undefined | 非受控初始值 |
open | boolean | undefined | undefined | 受控打开态 |
defaultOpen | boolean | false | 非受控初始打开态 |
options | array | undefined | 选项数据 |
placeholder | string | undefined | 占位 |
disabled | boolean | false | 禁用 |
readonly | boolean | false | 只读 |
multiple | boolean | false | 多选语义 |
SelectItem
| Prop | 类型 | 描述 |
|---|---|---|
option | object | 选项对象 |
Events
| Event | Payload | 描述 |
|---|---|---|
update:value | unknown | 值同步 |
valueChange | unknown | 值变化 |
update:open | boolean | 打开态同步 |
openChange | boolean | 打开态变化 |
无障碍
- Trigger 在普通与 readonly 状态下负责打开；disabled 时不能打开。
- Item 负责选择；readonly/disabled 时不应改 value。
aria-readonly由拥有选择语义的 role owner 暴露，不把 readonly 报告为 disabled。
平台差异
- H5 可实时预览打开/选择。
- 小程序侧浮层定位与 portal 策略由封装层处理。 :::