Skip to content

Tabs ​

选项卡运行时:Root 持有当前 value,Trigger/Content 通过相同 value 关联。

运行时 ​

状态契约由 @varo-ui/headless 提供;渲染 Parts 分别来自 @varo-ui/h5/primitives 与 @varo-ui/weapp/primitives。

演示 ​

安装包@varo-ui/headless
Panel A

基础用法 ​

通过上方演示面板切换 H5 与 Weapp primitive 预览/代码;每个运行时只渲染当前条目。

受控与唯一 value ​

同一 TabsRoot 内 Trigger/Content 的 value 必须唯一;H5 自动模式下支持方向键切换。

Parts ​

Part作用
TabsRoot当前 value 与 orientation
TabsListtrigger 容器
TabsTrigger单个标题
TabsContent对应面板

Props ​

TabsRoot ​

Prop类型默认值描述
valuestring | number | undefinedundefined受控激活项
defaultValuestring | numberundefined非受控初始项
orientationstringundefined方向语义
disabledbooleanfalse整组禁用
idstringundefined关联 id 前缀
asstring'div'根节点标签

TabsTrigger / TabsContent ​

Prop类型描述
valuestring | number与 Root 关联的唯一值
disabledboolean仅 Trigger 支持禁用

Events ​

EventPayload描述
update:valuestring | number受控同步
valueChangestring | number激活项变化

无障碍 ​

  • value 同时用于状态与 panel 关联。
  • H5 支持方向键/Home/End。
  • 小程序保留 ARIA 与 value 关联,不模拟浏览器焦点。

平台差异

  • H5 可演示键盘行为。
  • 小程序页签使用 Weapp primitive 运行时渲染当前 Tabs 条目。 :::