Tab 标签页

基础用法

通过active设定当前激活标签对应的索引值,默认情况下启用第一个标签

  1. <van-tabs active="{{ active }}" bind:change="onChange">
  2. <van-tab title="标签 1">内容 1</van-tab>
  3. <van-tab title="标签 2">内容 2</van-tab>
  4. <van-tab title="标签 3">内容 3</van-tab>
  5. <van-tab title="标签 4">内容 4</van-tab>
  6. </van-tabs>
  1. Page({
  2. active: 1
  3. },
  4. onChange(event) {
  5. wx.showToast({
  6. title: `切换到标签 ${event.detail.name}`,
  7. icon: 'none'
  8. });
  9. }
  10. });

通过名称匹配

在标签指定name属性的情况下,active的值为当前标签的name,默认启用第一个标签

  1. <van-tabs active="a">
  2. <van-tab title="标签 1" name="a">内容 1</van-tab>
  3. <van-tab title="标签 2" name="b">内容 2</van-tab>
  4. <van-tab title="标签 3" name="c">内容 3</van-tab>
  5. </van-tabs>

横向滚动

禁用标签

设置disabled属性即可禁用标签。如果需要监听禁用标签的点击事件,可以在van-tabs上监听disabled事件

  1. <van-tab title="标签 1">内容 1</van-tab>
  2. <van-tab title="标签 2" disabled>内容 2</van-tab>
  3. <van-tab title="标签 3">内容 3</van-tab>
  4. </van-tabs>
  1. Page({
  2. onClickDisabled(event) {
  3. wx.showToast({
  4. title: `标签 ${event.detail.name} 已被禁用`,
  5. icon: 'none'
  6. }
  7. });

Tab支持两种样式风格:linecard,默认为line样式,可以通过type属性修改样式风格

  1. <van-tabs type="card">
  2. <van-tab title="标签 1">内容 1</van-tab>
  3. <van-tab title="标签 2">内容 2</van-tab>
  4. <van-tab title="标签 3">内容 3</van-tab>
  5. </van-tabs>

点击事件

  1. Page({
  2. onClick(event) {
  3. wx.showToast({
  4. title: `点击标签 ${event.detail.name}`,
  5. icon: 'none'
  6. });
  7. });

粘性布局

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

  1. <van-tabs sticky>
  2. <van-tab title="标签 1">内容 1</van-tab>
  3. <van-tab title="标签 2">内容 2</van-tab>
  4. <van-tab title="标签 3">内容 3</van-tab>
  5. <van-tab title="标签 4">内容 4</van-tab>
  6. </van-tabs>

切换动画

可以通过animated来设置是否启用切换tab时的动画。

  1. <van-tabs animated>
  2. <van-tab title="标签 1">内容 1</van-tab>
  3. <van-tab title="标签 2">内容 2</van-tab>
  4. <van-tab title="标签 3">内容 3</van-tab>
  5. </van-tabs>

滑动切换

API

Tab Props

参数说明类型默认值版本
name标签名称,作为匹配的标识符string | number标签的索引值-
title标题string--
disabled是否禁用标签boolean-
dot是否显示小红点boolean--
info图标右上角提示信息string | number--
title-style自定义标题样式string--

Tabs Slot

Tab Slot

名称说明
-标签页内容

Tabs Event

类名说明
custom-class根节点样式类
nav-class标签栏样式类
tab-class标签样式类
tab-active-class标签激活态样式类