跳到主要内容

Tabs 标签页 ​

WebH5

标签页。横排标签栏切换内容,激活项带底部指示条,移动端支持横向滚动。整组只保留激活项一个 Tab 停靠点,←/→ 循环、Home/End 跳首尾并跟随激活,可关闭标签用 Delete 关闭;tab 与 tabpanel 通过 aria-controls / aria-labelledby 配对。

何时使用 ​

同层级内容之间的平级切换,且数量不多(移动端可横滚)。

何时不使用 ​

层级导航用菜单/侧边栏;表单分步用 Steps。

Props ​

名称类型默认值说明
modelValuestring""激活 tab 的 name,支持 v-model;缺省取第一个未禁用项
itemsArray<{ name: string; label: string; disabled?: boolean; closable?: boolean }>"[]"标签项;name 同时对应同名具名插槽;closable 可覆盖全局 closable
closableboolean"false"是否显示关闭按钮(可被 item.closable 覆盖)

Events ​

名称载荷说明
update:modelValuestring切换 tab 时触发,参数为新激活的 name
changestring切换 tab 时触发,参数为新激活的 name
closestring点击关闭按钮时触发,参数为被关闭 tab 的 name(需开启 closable)

Slots ​

名称说明
动态具名插槽插槽名 = item.name,仅渲染当前激活 name 对应的内容面板;不给插槽时只渲染标签栏

示例 ​

基础页签切换 ​

示例加载中…

带内容面板 ​

示例加载中…

事件监听 ​

示例加载中…

仅标签栏(无内容面板) ​

示例加载中…

业务场景:订单列表切换 ​

示例加载中…

可关闭标签(后台多页签) ​

示例加载中…

Playground ​

加载中…

跨端版本 ​

该组件同时提供 uni-app / uni-app X 实现(H5 / 微信小程序 / App),API 可能略有差异,见 uni-app 端 Tabs 文档(含手机预览)。