微信小程序之有赞组件Collapse折叠面板的使用

1. 使用指南

在 app.json 或 index.json 中引入组件
es6

"usingComponents": {
  "van-collapse": "path/to/vant-weapp/dist/collapse/index",
  "van-collapse-item": "path/to/vant-weapp/dist/collapse-item/index"
}

es5

"usingComponents": {
  "van-collapse": "path/to/vant-weapp/lib/collapse/index",
  "van-collapse-item": "path/to/vant-weapp/lib/collapse-item/index"
}

2. 代码演示

2.1 基础用法

通过value控制展开的面板列表，activeNames为数组格式

<van-collapse value="{{ activeNames }}" bind:change="onChange">
  <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>

Page({
  data: {
    activeNames: ['1']
  },
  onChange(event) {
    this.setData({
      activeNames: event.detail
    });
  }
});

2.2 手风琴

通过accordion可以设置为手风琴模式，最多展开一个面板，此时activeName为字符串格式

<van-collapse value="{{ activeName }}" bind:change="onChange" 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>

Page({
  data: {
    activeName: '1'
  },
  onChange(event) {
    this.setData({
      activeName: event.detail
    });
  }
});

2.3 自定义标题内容

<van-collapse value="{{ activeNames }}" bind:change="onChange">
  <van-collapse-item name="1">
    <view slot="title">有赞微商城<van-icon name="question-o" /></view>
    提供多样店铺模板，快速搭建网上商城
  </van-collapse-item>
  <van-collapse-item title="有赞零售" name="2" icon="shop-o">
    网店吸粉获客、会员分层营销、一机多种收款，告别经营低效和客户流失
  </van-collapse-item>
</van-collapse>

Page({
  data: {
    activeNames: ['1']
  },
  onChange(event) {
    this.setData({
      activeNames: event.detail
    });
  }
});

3. Collapse API

参数	说明	类型	默认值	版本
value	当前展开面板的 name	Array / String / Number	-
accordion	是否开启手风琴模式	Boolean	false
border	是否显示外边框	Boolean	true

4. Collapse Event

事件名	说明	参数
change	切换面板时触发	activeNames: String / Array

5. CollapseItem API

参数	说明	类型	默认值
name	唯一标识符，默认为索引值	String / Number	index
title	标题栏左侧内容	String / Number	-
icon	标题栏左侧图标名称或图片链接，可选值见 Icon 组件	String	-
value	标题栏右侧内容	String / Number	-
label	标题栏描述信息	String	-
border	是否显示内边框	Boolean	true
is-link	是否展示标题栏右侧箭头并开启点击反馈	Boolean	true
clickable	是否开启点击反馈	Boolean	false
disabled	是否禁用面板	Boolean	false

6. CollapseItem Slot

名称	说明
-	面板内容
value	自定义显示内容
icon	自定义icon
title	自定义title
right-icon	自定义右侧按钮，默认是arrow

7. Collapse 外部样式类

类名	说明
custom-class	根节点样式类

8. CollapseItem 外部样式类

类名	说明
custom-class	根节点样式类
content-class	内容样式类