vant/docs/markdown/zh-CN/tab.md

Tabs 标签页

使用指南

import { Tab, Tabs } from 'vant';

Vue.use(Tab).use(Tabs);

代码演示

基础用法

默认情况下启用第一个 tab，可以通过active属性激活对应特定索引的 tab

<van-tabs :active="active">
  <van-tab v-for="index in 4" :title="'选项 ' + index">
    内容 {{ index }}
  </van-tab>
</van-tabs>

export default {
  data() {
    return {
      active: 2
    };
  }
}

横向滚动

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

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

禁用标签

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

<van-tabs @disabled="onClickDisabled">
  <van-tab v-for="index in 4" :title="'选项 ' + index" :disabled="index === 2">
    内容 {{ index }}
  </van-tab>
</van-tabs>

export default {
  methods: {
    onClickDisabled() {
      Toast('Disabled!')
    }
  }
};

样式风格

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

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

点击事件

可以在van-tabs上绑定一个click事件，事件处理函数有一个参数，参数为对应tab在tabs中的索引。

<van-tabs @click="handleTabClick">
  <van-tab v-for="index in 4" :title="'选项 ' + index">
    内容 {{ index }}
  </van-tab>
</van-tabs>

export default {
  methods: {
    handleTabClick(index) {
      Toast(index);
    }
  }
};

粘性布局

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

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

自定义标签

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

<van-tabs :active="active">
  <van-tab v-for="index in 2">
    <div slot="title">
      <van-icon name="more-o" />选项
    </div>
    内容 {{ index }}
  </van-tab>
</van-tabs>

滑动切换

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

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

Tabs API

参数	说明	类型	默认值	可选
type	Tab 样式类型	String	line	card
active	默认激活的 tab	String Number	0	-
duration	切换 tab 的动画时间	Number	0.2	-
swipe-threshold	滚动阀值，设置 Tab 超过多少个可滚动	Number	4	-
sticky	是否使用粘性定位布局	Boolean	false	-
swipeable	是否可以滑动内容切换	Boolean	false	-

Tab API

参数	说明	类型	默认值	可选
title	tab的标题	String	-	-
disabled	是否禁用这个tab	Boolean	false	-

Tab Slot

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

Tabs Event

事件名	说明	参数
click	某个tab点击事件	index：点击的tab的索引
disabled	某个tab禁用时点击事件	index：点击的tab的索引