Skip to content

选项卡 Tabs ​

移动端顶部导航切换栏(标准高度 44px),内置贯穿全宽的 0.5px 极细底边线,选中态配有长 28px、高 3px 的绿色圆角指示条,支持在标题右侧挂载数量统计。

基本用法 ​

点击切换不同的标签页,指示条自动居中对齐当前激活项。

vue
<template>
  <Tabs :items="tabList" v-model="activeTab"/>
</template>

<script setup lang="ts">
import { ref } from 'vue'
import Tabs, { type TabItem } from '@/components/common/Tabs.vue'

const activeTab = ref('fav')
const tabList: TabItem[] = [
  { label: '我的收藏', value: 'fav' },
  { label: '常购清单', value: 'often' },
  { label: '推荐收藏', value: 'recommend' }
]
</script>

带数量角标(count) ​

在 items 数组中传入 count 字段,标题右侧会自动以 12px 字号展示括弧数量统计。

vue
<script setup lang="ts">
const tabList: TabItem[] = [
  { label: '全部商品', value: 'all', count: 128 },
  { label: '有活动', value: 'promo', count: 16 },
  { label: '已失效', value: 'expired', count: 0 }
]
</script>

API 参数说明 ​

参数名说明类型默认值
modelValue当前激活选项卡的 value(支持 v-model)string | number必填
items选项卡配置列表({ label, value, count? }[])TabItem[]必填