Tab 标签页

使用指南

  1. import { Tab, Tabs } from 'vant';
  2. Vue.use(Tab).use(Tabs);

代码演示

基础用法

默认情况下启用第一个 tab,可以通过v-model绑定当前激活的标签索引

  1. <van-tabs v-model="active">
  2. <van-tab v-for="index in 4" :title="'选项 ' + index">
  3. 内容 {{ index }}
  4. </van-tab>
  5. </van-tabs>
  1. export default {
  2. data() {
  3. return {
  4. active: 2
  5. };
  6. }
  7. }

横向滚动

默认情况下多于4个tab时,可以横向滚动tab。可以通过设置swipe-threshold这个阙值,多于这个阙值时,tab就会支持横向滚动。

  1. <van-tabs>
  2. <van-tab v-for="index in 8" :title="'选项 ' + index">
  3. 内容 {{ index }}
  4. </van-tab>
  5. </van-tabs>

禁用标签

在对应的van-tab上设置disabled属性即可。如果需要监听禁用事件,可以在van-tabs上监听disabled事件。

  1. <van-tabs @disabled="onClickDisabled">
  2. <van-tab v-for="index in 4" :title="'选项 ' + index" :disabled="index === 2">
  3. 内容 {{ index }}
  4. </van-tab>
  5. </van-tabs>
  1. export default {
  2. methods: {
  3. onClickDisabled(index, title) {
  4. this.- toast(title + '已被禁用');
  5. }
  6. }
  7. };

样式风格

Tabs目前有两种样式:linecard,默认为line样式,也就上面基础用法中的样式,你可以在van-tabs上设置typecard改为card样式。

  1. <van-tabs type="card">
  2. <van-tab v-for="index in 4" :title="'选项 ' + index">
  3. 内容 {{ index }}
  4. </van-tab>
  5. </van-tabs>

点击事件

可以在van-tabs上绑定click事件,事件传参为标签对应的索引和标题

  1. <van-tabs @click="onClick">
  2. <van-tab v-for="index in 4" :title="'选项 ' + index">
  3. 内容 {{ index }}
  4. </van-tab>
  5. </van-tabs>
  1. export default {
  2. methods: {
  3. onClick(index, title) {
  4. this.- toast(title);
  5. }
  6. }
  7. };

粘性布局

通过sticky属性可以开启粘性布局,粘性布局下,当 Tab 滚动到顶部时会自动吸顶

  1. <van-tabs v-model="active" sticky>
  2. <van-tab v-for="index in 4" :title="'选项 ' + index">
  3. 内容 {{ index }}
  4. </van-tab>
  5. </van-tabs>

自定义标签

通过 title slot 可以自定义标签内容

  1. <van-tabs v-model="active">
  2. <van-tab v-for="index in 2">
  3. <div slot="title">
  4. <van-icon name="more-o" />选项
  5. </div>
  6. 内容 {{ index }}
  7. </van-tab>
  8. </van-tabs>

滑动切换

通过swipeable属性可以开启滑动切换tab

  1. <van-tabs v-model="active" swipeable>
  2. <van-tab v-for="index in 4" :title="'选项 ' + index">
  3. 内容 {{ index }}
  4. </van-tab>
  5. </van-tabs>

Tabs API

参数 说明 类型 默认值
v-model 当前激活标签的索引 String Number 0
type 样式类型,可选值为 line card String line
duration 切换 tab 的动画时间 Number 0.2
line-width 底部条宽度 (px) Number 与当前标签等宽
swipe-threshold 滚动阀值,设置 Tab 超过多少个可滚动 Number 4
sticky 是否使用粘性定位布局 Boolean false
swipeable 是否可以滑动内容切换 Boolean false

Tab API

参数 说明 类型 默认值
title 标题 String -
disabled 是否禁用标签 Boolean false

Tab Slot

名称 说明
- 标签页内容
title 自定义标签

Tabs Event

事件名 说明 参数
click 点击标签时触发 index:标签索引,title:标题
disabled 点击被禁用的标签时触发 index:标签索引,title:标题

原文:

https://youzan.github.io/vant/#/zh-CN/tab