Collapse 折叠面板
使用折叠面板来收纳内容。
基础用法
您可以展开多个面板
手风琴
在手风琴模式下,一次只能展开一个面板
自定义标题
除了使用 title 属性之外,您还可以通过具名插槽来自定义面板标题,从而实现添加自定义内容,例如:图标。
提示
自版本 2.9.10 起,title 插槽提供了一个 isActive 属性,用于指示当前折叠项是否处于激活状态。
自定义图标 2.8.3
除了使用 icon 属性外,你还可以通过具名插槽来自定义面板的图标,从而添加自定义内容。
自定义图标位置 2.9.10
使用 expand-icon-position 属性,你可以自定义图标的位置。
阻止折叠 2.9.11
设置 before-collapse 属性,如果返回 false 或返回一个被拒绝的 Promise,将阻止折叠。
Collapse API
Collapse 属性
| 名称 | 描述 | 类型 | 默认值 |
|---|---|---|---|
| model-value / v-model | 当前激活的面板,手风琴模式下为 string,否则为 array | string / array | [] |
| accordion | 是否开启手风琴模式 | boolean | false |
| expand-icon-position 2.9.10 | 设置展开图标的位置 | 枚举 | 右侧 |
| before-collapse 2.9.11 | 折叠状态改变前的钩子。如果返回 false 或返回一个被拒绝的 Promise,将阻止折叠 | Function | — |
Collapse 事件
| 名称 | 描述 | 类型 |
|---|---|---|
| change | 当活动面板改变时触发,手风琴模式下参数类型为 string,否则为 array | Function |
Collapse 插槽
| 名称 | 描述 | 子标签 |
|---|---|---|
| default | 自定义默认内容 | Collapse Item |
Collapse Exposes
| 名称 | 描述 | 类型 |
|---|---|---|
| activeNames | 当前激活面板的名称 | object |
| setActiveNames | 设置激活面板的名称 | Function |
Collapse Item API
Collapse Item 属性
| 名称 | 描述 | 类型 | 默认值 |
|---|---|---|---|
| 名称 | 面板的唯一标识 | string / number | — |
| title | 面板的标题 | string | '' |
| icon 2.8.3 | 折叠项的图标 | string / Component | ArrowRight |
| disabled | 禁用折叠项 | boolean | false |
Collapse Item 插槽
| 名称 | 描述 | 类型 |
|---|---|---|
| default | Collapse Item 的内容 | — |
| title | Collapse Item 标题的内容 | object |
| icon 2.8.3 | Collapse Item 图标的内容 | object |
Collapse Item Exposes
| 名称 | 描述 | 类型 |
|---|---|---|
| isActive | 当前折叠项是否处于激活状态 | object |