底部导航栏 Tabbar

布局 · 可交互组件

底部应用导航

按需导入wbbb-ui/components/tabbar

基础用法

<script setup lang="ts">
import { ref } from 'vue'
import { WbbbTabbar } from 'wbbb-ui/components/tabbar'
import 'wbbb-ui/styles/tabbar'

const value = ref('')
</script>

<template>
  <WbbbTabbar v-model="value" />
</template>

真实移动端预览新窗口打开 ↗

状态与交互

以下状态均可在右侧的真实 Playground 中操作与验收。

默认按压选中禁用

API 参考

属性（Props）

属性	说明	类型	默认值	必填
`activeColor`	设置激活状态使用的颜色。	`string`	`'var(--wbbb-color-primary)'`	否
`fixed`	是否将组件固定在视口位置。	`boolean`	`true`	否
`inactiveColor`	设置未激活状态使用的颜色。	`string`	`'var(--wbbb-color-text-secondary)'`	否
`items`	提供组件需要渲染的数据项目。	`WbbbTabbarItem[]`	`() => []`	否
`modelValue`	提供 v-model 使用的当前值。	`string \\| number`	`''`	否
`safeAreaInsetBottom`	是否为设备底部安全区增加留白。	`boolean`	`true`	否
`zIndex`	设置组件的层叠层级。	`number`	`800`	否

事件（Events）

update:modelValue
change

插槽（Slots）

default

双向绑定

支持 v-model（modelValue）。

平台说明

构建验证：H5、App Vue、微信小程序、支付宝小程序与抖音小程序。

运行时差异：H5 支持键盘焦点与减弱动效；小程序端使用等价触控交互。上传、日期选择和服务弹层应在目标端再次验收。

使用提示：更多状态组合和跨端表现请在 Playground 中验证。

底部导航栏 Tabbar ​

基础用法 ​

状态与交互 ​

API 参考 ​