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

安装

bash
pnpm add @varo-ui/headless @varo-ui/h5
# 或
pnpm add @varo-ui/headless @varo-ui/weapp

基础用法

通过上方演示面板切换 H5 实时预览,以及小程序运行时契约/代码。

受控与唯一 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 可演示键盘行为。
  • 小程序文档展示运行时契约,不伪装成真机预览。

相关文档