组件/TabBar 底部导航
通用组件

TabBar 底部导航

移动端底部 TabBar,支持图标与 badge。

该页面由 AI 迁移生成,请谨慎使用

内容已迁移完成,但仍建议结合源码和人工评审结果使用。

TabBar 底部导航

移动端底部 TabBar,支持图标与 badge。

基础用法

TabBar

示例即将加载...
<script setup lang="ts">
import { ref } from 'vue'

const value = ref('home')

const items = [
  { value: 'home', label: 'Home', iconClass: 'i-carbon-home' },
  { value: 'search', label: 'Search', iconClass: 'i-carbon-search', badge: 3 },
  { value: 'profile', label: 'Me', iconClass: 'i-carbon-user' },
]
</script>

<template>
  <div style="width: 360px; height: 220px; border: 1px solid var(--tx-border-color); border-radius: 12px; overflow: hidden; position: relative;">
    <div style="padding: 16px; color: var(--tx-text-color-secondary);">
      Active: {{ value }}
    </div>

    <TxTabBar v-model="value" :items="items" />
  </div>
</template>

API

Props

属性名类型默认值说明
modelValuestring | number''当前值(v-model)
itemsTabBarItem[][]数据源
fixedbooleantrue是否 fixed 底部
safeAreaBottombooleantrue是否预留底部安全区
disabledbooleanfalse禁用
zIndexnumber2000z-index

TabBarItem

字段类型说明
valuestring | number唯一值
labelstring文案
iconClassstring图标 class
badgestring | numberbadge
disabledboolean禁用

Events

事件名参数说明
update:modelValue(value)v-model 更新
change(value)值变化