Skip to content

Collapse 折叠面板

通过折叠面板收纳内容区域。

基础用法

可同时展开多个面板,默认第一个参数为数组。

手风琴效果

每次只能展开一个面板。

通过 accordion 属性来设置是否以手风琴模式显示。

自定义面板标题

除了可以通过 title 属性以外,还可以通过具名 slot 来实现自定义面板的标题内容,以实现增加图标等效果。

✨ 毛玻璃风格 (Unique)

独特的半透明毛玻璃风格,适用于现代感强的界面。

type 设置为 glass

✨ 幽灵模式 (Unique)

极简风格,移除边框和背景,仅保留必要的分割线。

type 设置为 ghost

✨ 专注模式 (Unique)

当展开某一项时,非激活项会自动变暗,引导用户关注当前内容。

设置 focus-mode 属性。

✨ 自定义箭头位置

可以将箭头放置在左侧,符合特定的阅读习惯。

设置 arrow-placement 属性为 left

API

Collapse Attributes

属性名说明类型默认值
model-value / v-model当前激活的面板(如果是手风琴模式,绑定值类型需要为string,否则为array)string / number / array-
accordion是否是手风琴模式booleanfalse
type风格类型'default' / 'card' / 'glass' / 'ghost''default'
focus-mode是否开启专注模式 (非激活项变暗)booleanfalse
arrow-placement箭头位置'left' / 'right' / 'none''right'

Collapse Events

事件名说明参数
change当前激活面板改变时触发(如果是手风琴模式,参数 activeNames 类型为string,否则为array)(activeNames: string | number | array)

CollapseItem Attributes

属性名说明类型默认值
name唯一标志符string / number-
title面板标题string-
disabled是否禁用booleanfalse
icon自定义图标string / Component-

CollapseItem Slots

插槽名说明
default面板内容
title标题内容
icon标题图标
extra标题右侧内容