mirror of
https://gitee.com/vant-contrib/vant.git
synced 2025-10-31 19:42:07 +08:00
126 lines
3.7 KiB
Markdown
126 lines
3.7 KiB
Markdown
## Collapse 折叠面板
|
|
|
|
### 使用指南
|
|
``` javascript
|
|
import { Collapse, CollapseItem } from 'vant';
|
|
|
|
Vue.use(Collapse).use(CollapseItem);
|
|
```
|
|
|
|
### 代码演示
|
|
|
|
#### 基础用法
|
|
通过`v-model`控制展开的面板列表，`activeNames`为数组格式
|
|
|
|
```html
|
|
<van-collapse v-model="activeNames">
|
|
<van-collapse-item title="有赞微商城" name="1">
|
|
提供多样店铺模板，快速搭建网上商城
|
|
</van-collapse-item>
|
|
<van-collapse-item title="有赞零售" name="2">
|
|
网店吸粉获客、会员分层营销、一机多种收款，告别经营低效和客户流失
|
|
</van-collapse-item>
|
|
<van-collapse-item title="有赞美业" name="3" disabled>
|
|
线上拓客，随时预约，贴心顺手的开单收银
|
|
</van-collapse-item>
|
|
</van-collapse>
|
|
```
|
|
|
|
``` javascript
|
|
export default {
|
|
data() {
|
|
return {
|
|
activeNames: ['1']
|
|
};
|
|
}
|
|
};
|
|
```
|
|
|
|
#### 手风琴
|
|
通过`accordion`可以设置为手风琴模式，最多展开一个面板，此时`activeName`为字符串格式
|
|
|
|
```html
|
|
<van-collapse v-model="activeName" accordion>
|
|
<van-collapse-item title="有赞微商城" name="1">
|
|
提供多样店铺模板，快速搭建网上商城
|
|
</van-collapse-item>
|
|
<van-collapse-item title="有赞零售" name="2">
|
|
网店吸粉获客、会员分层营销、一机多种收款，告别经营低效和客户流失
|
|
</van-collapse-item>
|
|
<van-collapse-item title="有赞美业" name="3">
|
|
线上拓客，随时预约，贴心顺手的开单收银
|
|
</van-collapse-item>
|
|
</van-collapse>
|
|
```
|
|
|
|
``` javascript
|
|
export default {
|
|
data() {
|
|
return {
|
|
activeName: '1'
|
|
};
|
|
}
|
|
};
|
|
```
|
|
|
|
#### 自定义标题内容
|
|
|
|
```html
|
|
<van-collapse v-model="activeNames">
|
|
<van-collapse-item name="1">
|
|
<div slot="title">有赞微商城<van-icon name="question-o" /></div>
|
|
提供多样店铺模板，快速搭建网上商城
|
|
</van-collapse-item>
|
|
<van-collapse-item
|
|
title="有赞零售"
|
|
name="2"
|
|
icon="shop-o"
|
|
>
|
|
网店吸粉获客、会员分层营销、一机多种收款，告别经营低效和客户流失
|
|
</van-collapse-item>
|
|
</van-collapse>
|
|
```
|
|
|
|
|
|
|
|
### Collapse API
|
|
|
|
| 参数 | 说明 | 类型 | 默认值 | 版本 |
|
|
|------|------|------|------|------|
|
|
| v-model | 当前展开面板的 name | `Array | String | Number` | - | - |
|
|
| accordion | 是否开启手风琴模式 | `Boolean` | `false` | - |
|
|
| border | 是否显示外边框 | `Boolean` | `true` | 1.6.9 |
|
|
|
|
### Collapse Event
|
|
|
|
| 事件名 | 说明 | 参数 |
|
|
|------|------|------|
|
|
| change | 切换面板时触发 | activeNames: `string | array` |
|
|
|
|
### CollapseItem API
|
|
|
|
| 参数 | 说明 | 类型 | 默认值 | 版本 |
|
|
|------|------|------|------|------|------|
|
|
| name | 唯一标识符，默认为索引值 | `String | Number` | `index` | - |
|
|
| icon | 标题栏左侧图标名称或图片链接，可选值见 Icon 组件 | `String` | - | 1.2.1 |
|
|
| size | 标题栏大小，可选值为 `large` | `String` | - | 1.6.9 |
|
|
| title | 标题栏左侧内容 | `String | Number` | - | - |
|
|
| value | 标题栏右侧内容 | `String | Number` | - | 1.2.1 |
|
|
| label | 标题栏描述信息 | `String | Number` | - | 1.2.1 |
|
|
| border | 是否显示内边框 | `Boolean` | `true` | 1.2.1 |
|
|
| is-link | 是否展示标题栏右侧箭头并开启点击反馈 | `Boolean` | `true` | 1.2.1 |
|
|
| disabled | 是否禁用面板 | `Boolean` | `false` | 1.3.6 |
|
|
| title-class | 左侧标题额外类名 | `String` | - | 1.4.8 |
|
|
| value-class | 右侧内容额外类名 | `String` | - | 1.4.8 |
|
|
| label-class | 描述信息额外类名 | `String` | - | 1.4.8 |
|
|
|
|
### CollapseItem Slot
|
|
|
|
| 名称 | 说明 |
|
|
|------|------|
|
|
| - | 面板内容 |
|
|
| value | 自定义显示内容 |
|
|
| icon | 自定义`icon` |
|
|
| title | 自定义`title` |
|
|
| right-icon | 自定义右侧按钮，默认是`arrow` |
|