Skip to content

Tabs 标签页

Tabs 标签页组件用于在同一块区域内,通过标签页的形式,展示不同的内容模块,实现内容的分组切换展示。

参数

Props

名称类型默认值描述
modelValuestring | number-当前激活的标签页,对应 items 中的 id 值
itemsTabItem[][]标签页数据
type'line' | 'card' | 'round''line'标签页类型
direction'horizontal' | 'vertical''horizontal'标签页方向
closablebooleanfalse是否可关闭标签页
addablebooleanfalse是否可新增标签页
beforeChange(id: string | number) => boolean | Promise<boolean>-切换前的钩子函数。返回 true 则切换,返回 false 则不切换

TabItem

名称类型默认值描述
idstring | number-标签页唯一标识
labelstring-标签页标题
iconstring-标签页图标
disabledbooleanfalse是否禁用
closablebooleanfalse是否可关闭

Slots

名称描述参数
default标签页内容-

Events

名称描述参数
update:modelValue激活标签页改变时触发(value: string | number) => void
change标签页切换时触发(value: string | number) => void
close关闭标签页时触发(id: string | number) => void
add点击新增按钮时触发-

示例

基础用法

指定展示的页签

不同类型

纵向标签页

带图标

可关闭标签页

可新增标签页

TypeScript

ts
export interface TabItem {
  // 标签页唯一标识
  id?: string | number;
  // 标签页标题
  label: string;
  // 标签页图标
  icon?: string;
  // 是否禁用
  disabled?: boolean;
  // 是否可关闭
  closable?: boolean;
}