vant-Tab 标签页

引入

代码演示

基础用法

通过 `v-model` 绑定当前激活标签对应的索引值，默认情况下启用第一个标签。

通过名称匹配

在标签指定 `name` 属性的情况下，`v-model` 的值为当前标签的 `name`（此时无法通过索引值来匹配标签）。

标签栏滚动

标签数量超过 5 个时，标签栏可以在水平方向上滚动，切换时会自动将当前标签居中。

禁用标签

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

样式风格

`Tab` 支持两种样式风格：`line` 和`card`，默认为 `line` 样式，可以通过 `type` 属性切换样式风格。

点击事件

可以在 `van-tabs` 上绑定 `click` 事件，事件传参为标签对应的标识符和标题。

粘性布局

通过 `sticky` 属性可以开启粘性布局，粘性布局下，标签页滚动到顶部时会自动吸顶。

自定义标签

通过 `title` 插槽可以自定义标签内容。

切换动画

通过 `animated` 属性可以开启切换标签内容时的转场动画。

滑动切换

通过 `swipeable` 属性可以开启滑动切换标签页。

滚动导航

通过 `scrollspy` 属性可以开启滚动导航模式，该模式下，内容将会平铺展示。

异步切换

通过 `before-change` 属性可以在切换标签前执行特定的逻辑。

API

Tabs Props

参数	说明	类型	默认值
v-model	绑定当前选中标签的标识符	number / string	`0`
type	样式风格类型，可选值为 `card`	string	`line`
color	标签主题色	string	`#ee0a24`
background	标签栏背景色	string	`white`
duration	动画时间，单位秒	number / string	`0.3`
line-width	底部条宽度，默认单位 `px`	number / string	`40px`
line-height	底部条高度，默认单位 `px`	number / string	`3px`
animated	是否开启切换标签内容时的转场动画	boolean	`false`
border	是否显示标签栏外边框，仅在 `type="line"` 时有效	boolean	`false`
ellipsis	是否省略过长的标题文字	boolean	`true`
sticky	是否使用粘性定位布局	boolean	`false`
swipeable	是否开启手势滑动切换	boolean	`false`
lazy-render	是否开启延迟渲染（首次切换到标签时才触发内容渲染）	boolean	`true`
scrollspy	是否开启滚动导航	boolean	`false`
offset-top `v2.8.7`	粘性定位布局下与顶部的最小距离，支持 `px` `vw` `vh` `rem` 单位，默认 `px`	number / string	`0`
swipe-threshold	滚动阈值，标签数量超过阈值且总宽度超过标签栏宽度时开始横向滚动	number / string	`5`
title-active-color	标题选中态颜色	string	-
title-inactive-color	标题默认态颜色	string	-
before-change `v2.9.3`	切换标签前的回调函数，返回 `false` 可阻止切换，支持返回 Promise	(name) => boolean / Promise	-

Tab Props

参数	说明	类型	默认值
title	标题	string	-
disabled	是否禁用标签	boolean	`false`
dot	是否在标题右上角显示小红点	boolean	`false`
badge `v2.5.6`	图标右上角徽标的内容	number / string	-
info	图标右上角徽标的内容（已废弃，请使用 badge 属性）	number / string	-
name	标签名称，作为匹配的标识符	number / string	标签的索引值
url	点击后跳转的链接地址	string	-
to	点击后跳转的目标路由对象，同 vue-router 的 [to 属性](https://router.vuejs.org/zh/api/#to)	string / object	-
replace	是否在跳转时替换当前页面历史	boolean	`false`
title-style	自定义标题样式	any	-
title-class	自定义标题类名	any	-

Tabs Events

事件名	说明	回调参数
click	点击标签时触发	name：标识符，title：标题
change	当前激活的标签改变时触发	name：标识符，title：标题
disabled	点击被禁用的标签时触发	name：标识符，title：标题
rendered	标签内容首次渲染时触发（仅在开启延迟渲染后触发）	name：标识符，title：标题
scroll	滚动时触发，仅在 sticky 模式下生效	{ scrollTop: 距离顶部位置, isFixed: 是否吸顶 }

Tabs 方法

通过 ref 可以获取到 Tabs 实例并调用实例方法，详见

组件实例方法

。

	方法名	说明	参数	返回值
	resize	外层元素大小或组件显示状态变化时，可以调用此方法来触发重绘	-	-
	scrollTo `v2.9.3`	滚动到指定的标签页，在滚动导航模式下可用	name: 标识符	-

Tabs Slots

	名称	说明
	nav-left	标题左侧内容
	nav-right	标题右侧内容

Tab Slots

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

样式变量

组件提供了下列 Less 变量，可用于自定义样式，使用方法请参考

主题定制

。

名称	默认值	描述
@tab-text-color	`@gray-7`	-
@tab-active-text-color	`@text-color`	-
@tab-disabled-text-color	`@gray-5`	-
@tab-font-size	`@font-size-md`	-
@tab-line-height	`@line-height-md`	-
@tabs-default-color	`@red`	-
@tabs-line-height	`44px`	-
@tabs-card-height	`30px`	-
@tabs-nav-background-color	`@white`	-
@tabs-bottom-bar-width	`40px`	-
@tabs-bottom-bar-height	`3px`	-
@tabs-bottom-bar-color	`@tabs-default-color`	-

常见问题

组件从隐藏状态切换到显示状态时，底部条位置错误？

Tabs 组件在挂载时，会获取自身的宽度，并计算出底部条的位置。如果组件一开始处于隐藏状态，则获取到的宽度永远为 0，因此无法展示底部条位置。

解决方法

方法一，如果是使用 `v-show` 来控制组件展示的，则替换为 `v-if` 即可解决此问题：

方法二，调用组件的 resize 方法来主动触发重绘：

效果图：

打赏分享

引入