Tabs 标签页
分隔内容上有关联但属于不同类别的数据集合。
基础用法
基础简洁的标签页。
Tabs 组件提供了选项卡功能。 默认选中第一个标签页,你也可以通过 value
属性来指定当前选中的标签页。
卡片风格
卡片化的标签页。
将 type
设置为 card
就可以使选项卡改变为标签风格。
带边框的卡片
带边框的卡片化标签。
设置 type
属性为 border-card
。
标签位置
您可以使用 tab-position
属性设置标签的位置。
您可以从四个方向中选择:tabPosition="left|right|top|bottom"
自定义标签页
您可以使用具名插槽来定制标签页的内容。
增加和关闭标签页
只有卡片样式的标签页支持增加和关闭选项。
自定义添加按钮图标 2.4.0
自定义新标签页的触发器
Tabs API
Tabs 属性
名称 | 描述 | 类型 | 默认值 |
---|---|---|---|
model-value / v-model | 绑定值,选中选项卡的 name,默认值为第一个选项卡的 name | string / number | — |
type | 标签页的类型 | 枚举 | '' |
可关闭 | 标签是否可关闭 | boolean | false |
可增加的 | 标签页是否可增加 | boolean | false |
可编辑 | 标签页是否可增加和关闭 | boolean | false |
tab-position | 选项卡所在位置 | 枚举 | 上 |
stretch | 标签的宽度是否自撑开 | boolean | false |
before-leave | 切换标签之前的钩子,若返回 false 或者返回 Promise 且被 reject,则阻止切换 | Function | () => true |
Tabs 事件
名称 | 描述 | 参数 |
---|---|---|
tab-click | tab 被选中时触发 | Function |
tab-change | activeName 改变时触发 | Function |
tab-remove | 点击 tab 移除按钮后触发 | Function |
tab-add | 点击 tab 新增按钮后触发 | Function |
edit | 点击 tab 新增按钮或移除按钮后触发 | Function |
Tabs 插槽
名称 | 描述 | 子标签 |
---|---|---|
default | 自定义默认内容 | 标签页 |
add-icon 2.5.4 | 自定义添加按钮图标 | — |
addIcon 2.4.0 已废弃 | 自定义添加按钮图标 | — |
Tabs Exposes
名称 | 描述 | 类型 |
---|---|---|
currentName | 当前活动的 pane 的 name | object |
tabNavRef 2.9.10 | tab-nav 组件实例 | object |
Tab-nav API
Tab-nav Exposes
名称 | 描述 | 类型 |
---|---|---|
scrollToActiveTab | 滚动到活动的标签页 | Function |
removeFocus | 移除焦点状态 | Function |
tabListRef 2.9.10 | el_tabs__nav html 元素 | object |
tabBarRef 2.9.10 | el_tabs__nav bar 实例 | object |
Tab-pane API
Tab-pane 属性
名称 | 描述 | 类型 | 默认值 |
---|---|---|---|
label | 选项卡标题 | string | '' |
disabled | 该选项卡是否被禁用 | boolean | false |
名称 | 与选项卡绑定值 value 对应的标识符,表示选项卡别名,默认为选项卡在序列中的序号,如第一个选项卡为“0” | string / number | — |
可关闭 | 标签是否可关闭 | boolean | false |
lazy | 标签是否延迟渲染 | boolean | false |
Tab-pane 插槽
名称 | 描述 |
---|---|
default | 标签页的内容 |
label | 标签页的标签 |
类型声明
显示声明
ts
type TabBarInstance = InstanceType<typeof TabBar> & {
/** @description tab root html element */
ref: barRef
/** @description method to manually update tab bar style */
update
}