47 lines
2.2 KiB
Markdown
47 lines
2.2 KiB
Markdown
---
|
||
category: Components
|
||
type: 数据展示
|
||
title: Collapse
|
||
subtitle: 折叠面板
|
||
cover: https://gw.alipayobjects.com/zos/alicdn/IxH16B9RD/Collapse.svg
|
||
---
|
||
|
||
可以折叠/展开的内容区域。
|
||
|
||
## 何时使用
|
||
|
||
- 对复杂区域进行分组和隐藏，保持页面的整洁。
|
||
- '手风琴' 是一种特殊的折叠面板，只允许单个内容区域展开。
|
||
|
||
## API
|
||
|
||
### Collapse
|
||
|
||
| 参数 | 说明 | 类型 | 默认值 | 版本 |
|
||
| --- | --- | --- | --- | --- |
|
||
| activeKey(v-model) | 当前激活 tab 面板的 key | string\[]\|string | 默认无，accordion 模式下默认第一个元素 | |
|
||
| bordered | 带边框风格的折叠面板 | boolean | `true` | |
|
||
| collapsible | 所有子面板是否可折叠或指定可折叠触发区域 | `header` \| `disabled` | - | 3.0 |
|
||
| accordion | 手风琴模式 | boolean | `false` | |
|
||
| expandIcon | 自定义切换图标 | Function(props):VNode \| slot="expandIcon" slot-scope="props"\|#expandIcon="props" | |
|
||
| expandIconPosition | 设置图标位置： `left`, `right` | `left` | - | 1.5.0 |
|
||
| ghost | 使折叠面板透明且无边框 | boolean | false | 3.0 |
|
||
| destroyInactivePanel | 销毁折叠隐藏的面板 | boolean | `false` | |
|
||
|
||
### 事件
|
||
|
||
| 事件名称 | 说明 | 回调参数 | 版本 |
|
||
| -------- | -------------- | ------------- | ---- |
|
||
| change | 切换面板的回调 | function(key) | |
|
||
|
||
### Collapse.Panel
|
||
|
||
| 参数 | 说明 | 类型 | 默认值 | 版本 |
|
||
| ----------- | ------------------------------------------ | ---------------- | ------ | ----- |
|
||
| collapsible | 是否可折叠或指定可折叠触发区域 | `header` \| `disabled` | - | 3.0 |
|
||
| forceRender | 被隐藏时是否渲染 DOM 结构 | boolean | false | |
|
||
| header | 面板头内容 | string\|slot | 无 | |
|
||
| key | 对应 activeKey | string \| number | 无 | |
|
||
| showArrow | 是否展示当前面板上的箭头 | boolean | `true` | |
|
||
| extra | 自定义渲染每个面板右上角的内容 | VNode \| slot | - | 1.5.0 |
|