Tab

`CuiTab` 负责在同一页面内切换多段内容或状态区域,适合资料、日志和附件等并列信息组织。

CuiTab

CuiTab 负责在同一页面内切换多段内容或状态区域,适合资料、日志和附件等并列信息组织。

基础标签页

演示多标签内容切换和当前状态保持

Live Demo

Preview

Code

先看效果,再决定是否展开代码细节。

<script setup lang="ts">
import TabBasicDemo from "~/app/components/demo/TabBasicDemo.vue";
</script>

<template>
    <TabBasicDemo />
</template>

核心 Props

标签页常用配置

属性类型说明
tabsCuiTabItem[]标签项数组
activeTabstring当前激活标识
editableboolean是否允许编辑标签

完整 Props

属性类型默认值说明
tabsCuiTabItem[]Tab 列表(必填)
activeTabstring当前活跃 Tab 名,支持 v-model:activeTab(必填)
type'card' | 'border-card''card'Tab 样式
closablebooleanfalse是否允许关闭 Tab
addablebooleanfalse是否允许新增 Tab
editableType'add' | 'remove' | 'both''add'可编辑模式

CuiTabItem 配置

属性类型说明
labelstringTab 标签文字(必填)
namestringTab 唯一标识(必填)
contentstring面板内容(无插槽时显示文本)
disabledboolean是否禁用
closableboolean是否可关闭(覆盖 closable prop)

Emits

事件名参数说明
update:activeTab(value: string | number)当前 Tab 更新
tab-change(value: string | number)Tab 切换
add()点击新增 Tab 按钮
remove(value: string | number)关闭 Tab

Slots

插槽名Scope说明
tab-{name}(动态名){ tab: CuiTabItem }各 Tab 面板内容,优先于 tab.content 文本