Tabs 标签页
WebH5
标签页。横排标签栏切换内容,激活项带底部指示条,移动端支持横向滚动。整组只保留激活项一个 Tab 停靠点,←/→ 循环、Home/End 跳首尾并跟随激活,可关闭标签用 Delete 关闭;tab 与 tabpanel 通过 aria-controls / aria-labelledby 配对。
何时使用
同层级内容之间的平级切换,且数量不多(移动端可横滚)。
何时不使用
层级导航用菜单/侧边栏;表单分步用 Steps。
Props
| 名称 | 类型 | 默认值 | 说明 |
|---|---|---|---|
modelValue | string | "" | 激活 tab 的 name,支持 v-model;缺省取第一个未禁用项 |
items | Array<{ name: string; label: string; disabled?: boolean; closable?: boolean }> | "[]" | 标签项;name 同时对应同名具名插槽;closable 可覆盖全局 closable |
closable | boolean | "false" | 是否显示关闭按钮(可被 item.closable 覆盖) |
Events
| 名称 | 载荷 | 说明 |
|---|---|---|
update:modelValue | string | 切换 tab 时触发,参数为新激活的 name |
change | string | 切换 tab 时触发,参数为新激活的 name |
close | string | 点击关闭按钮时触发,参数为被关闭 tab 的 name(需开启 closable) |
Slots
| 名称 | 说明 |
|---|---|
动态具名插槽 | 插槽名 = item.name,仅渲染当前激活 name 对应的内容面板;不给插槽时只渲染标签栏 |
示例
基础页签切换
示例加载中…
带内容面板
示例加载中…
事件监听
示例加载中…
仅标签栏(无内容面板)
示例加载中…
业务场景:订单列表切换
示例加载中…
可关闭标签(后台多页签)
示例加载中…
Playground
加载中…
跨端版本
该组件同时提供 uni-app / uni-app X 实现(H5 / 微信小程序 / App),API 可能略有差异,见 uni-app 端 Tabs 文档(含手机预览)。