TabBar 标签栏
WebH5
移动端底部标签栏。56px 高,图标 22px + 文案,支持角标(数字胶囊/小红点),吸底时自动叠加底部安全区。
何时使用
移动端一级导航,3-5 个平级页面的底部切换。
何时不使用
页面内局部 tab 切换(用 Tabs);层级返回导航用 NavBar。
Props
| 名称 | 类型 | 默认值 | 说明 |
|---|---|---|---|
modelValue | string | "\"\"" | 激活项 name(v-model) |
items | TabBarItem[] | "[]" | 标签项:{ name, label, icon?, badge? };icon 内置 home/menu/star/user,未知名称显示圆点占位;badge 为 'dot' 显示小红点,其余显示数字胶囊 |
fixed | boolean | false | 吸底固定,padding-bottom 自动叠加 --rn-safe-area-bottom |
ariaLabel | string | "" | 导航区的 aria-label;为空时取 locale 文案 tabbar.label(默认「主导航」) |
Events
| 名称 | 载荷 | 说明 |
|---|---|---|
update:modelValue | string | 点击标签项时触发,payload 为该项 name |
change | string | 激活项变化时触发(点击当前项不触发) |
示例
电商主导航
示例加载中…
<TabBar v-model="active" :items="[
{ name: 'home', label: '首页', icon: 'home' },
{ name: 'category', label: '分类', icon: 'menu' },
{ name: 'cart', label: '购物车', icon: 'star', badge: 3 },
{ name: 'mine', label: '我的', icon: 'user', badge: 'dot' },
]" />无角标
示例加载中…
<TabBar v-model="active" :items="[
{ name: 'home', label: '发现', icon: 'home' },
{ name: 'fav', label: '收藏', icon: 'star' },
{ name: 'mine', label: '我的', icon: 'user' },
]" />切换回显 + change 事件
示例加载中…
<Stack :gap="8">
<TabBar
v-model="active"
:items="[
{ name: 'home', label: '首页', icon: 'home' },
{ name: 'search', label: '搜索', icon: 'search' },
{ name: 'user', label: '我的', icon: 'user' }
]"
@change="ev2 = 'change:' + $event"
/>
<span style="color:var(--rn-color-text-secondary);font-size:var(--rn-font-size-sm)">
当前值:{{ active }}{{ ev2 ? ' · ' + ev2 : '' }}
</span>
</Stack>Playground
加载中…
跨端版本
该组件同时提供 uni-app / uni-app X 实现(H5 / 微信小程序 / App),API 可能略有差异,见 uni-app 端 TabBar 文档(含手机预览)。