Collapse 折叠面板

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

基础用法

可同时展开多个面板,面板之间不影响

手风琴效果

每次只能展开一个面板

自定义面板标题

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

TIP

从版本 2.9.10开始, title 插槽提供一个 isActive 属性,显示当前折叠项是否活跃。

自定义图标 2.8.3

除了使用 icon 属性外,您还可以自定义面板项目图标,从而添加自定义内容。

自定义图标位置 2.9.10

使用 expand-icon-position 属性,您可以自定义图标位置。

阻止折叠 2.9.11

设置 beforeChange 属性,若返回 false 或者返回 Promise 且被 reject ,则停止切换。

Collapse API

Collapse Attributes

属性名详情类型默认值
model-value / v-model当前活动面板,在手风琴模式下其类型是string,在其他模式下是arraystring / array[]
accordion是否手风琴模式booleanfalse
expand-icon-position 2.9.10设置展开图标位置enumright
before-collapse 2.9.11折叠状态更改之前的折叠钩子。 返回 false 或者返回 Promise 且被 reject 则停止切换Function

Collapse Events

事件名说明类型
change切换当前活动面板,在手风琴模式下其类型是string,在其他模式下是arrayFunction

Collapse Slots

插槽名Description子标签
default自定义默认内容Collapse Item

Collapse Exposes

方法名说明类型
activeNames当前活动的面板名称object
setActiveNames设置活动面板名称Function

Collapse Item API

Collapse Item Attributes

属性名说明Type默认值
name唯一标志符string / number
title面板标题string''
icon 2.8.3折叠项目的图标string / ComponentArrowRight
disabled是否禁用booleanfalse

Collapse Item Slot

NameDescriptionType
defaultCollapse Item 的内容
titleCollapse Item 的标题object
icon 2.8.3折叠项目图标的内容object

Collapse Item Exposes

NameDescriptionType
isActive当前折叠项是否激活object

源代码

组件样式文档

贡献者