Tabs 标签页
uni-appH5微信小程序App
跨端横向标签页,支持 v-model、禁用、关闭和具名内容插槽。
何时使用
同层级内容之间的平级切换,且数量不多(移动端可横滚)。
何时不使用
层级导航用菜单/侧边栏;表单分步用 Steps。
本文档为 uni-app 端组件契约;Web 端同名组件 API 可能略有差异,请以对应包文档为准。下方手机预览实时运行 uni-app H5 演示。
Props
| 名称 | 类型 | 默认值 | 说明 |
|---|---|---|---|
modelValue | string | "" | 激活 tab 的 name,支持 v-model;缺省取第一个未禁用项 |
items | TabItem[] | [] | 标签项;name 同时对应同名具名插槽;closable 可覆盖全局 closable |
closable | boolean | false | 是否显示关闭按钮(可被 item.closable 覆盖) |
Events
| 名称 | 载荷 | 说明 |
|---|---|---|
update:modelValue | string | 切换 tab 时触发,参数为新激活的 name |
change | string | 切换 tab 时触发,参数为新激活的 name |
close | string | 点击关闭按钮时触发,参数为被关闭 tab 的 name(需开启 closable) |
Slots
| 名称 | 说明 |
|---|---|
<tab name> | 与 item.name 对应的标签内容 |
示例
基础用法
vue
<Tabs v-model="tab" :items="items">
<template #a><Text variant="secondary">概览面板内容</Text></template>
<template #b><Text variant="secondary">明细面板内容</Text></template>
<template #c><Text variant="secondary">设置面板内容</Text></template>
</Tabs>禁用项
vue
<Tabs v-model="tab1" :items="[{ name: 'a', label: '进行中' }, { name: 'b', label: '已结束', disabled: true }]" />可关闭
vue
<Tabs v-model="tab2" closable :items="[{ name: 'a', label: 'index.vue' }, { name: 'b', label: 'meta.json' }]" />