基本使用
# 基本使用
# 概述
基于 el-tabs 的增强型标签组件,提供了更丰富的功能,包括标签页未激活时不渲染、缓存、刷新、过渡动画等特性。
# 示例
# API
属性名 | 类型 | 默认值 | 说明 |
---|---|---|---|
value/v-model | String/Number | - | 当前激活的标签页名称 |
tabList | Array | [] | 标签页配置列表 |
cache | Boolean | true | 是否缓存标签页内容 |
all | Boolean/Object | false | 是否显示"全部"标签页 |
border | Boolean | false | 是否显示边框样式 |
cacheActive | Boolean | true | 是否在路由中缓存激活的标签页 |
refresh | Boolean | false | 是否显示刷新按钮 |
lazy | Boolean | true | 默认不加载未激活页面,false则加载全部 |
# tabList 配置项
[
{
label: '标签名称', // 显示的标签文本
name: 'tabName', // 标签的唯一标识
icon: 'el-icon-date', // 可选,标签页图标
cache: true, // 可选,是否缓存该标签页内容
render: () => { }, // 可选,render函数自定义标签页内容
}
]
# 事件
事件名 | 说明 | 回调参数 |
---|---|---|
tab-click | 标签页被点击时触发 | 被点击的标签页 |
refresh | 刷新标签页时触发 | (tab,index) |
# 特性说明
标签页未激活时不渲染 + 标签页缓存
v-if与v-show的结合使用,未激活时不会渲染,激活时会渲染
默认开启缓存功能,切换标签页不会销毁内容
路由缓存
启用cacheActive后,激活的标签页会被记录在路由query中
刷新页面后会自动恢复到之前激活的标签页