Collapse 折叠面板

介绍

将一组内容放置在多个折叠面板中,点击面板的标题可以展开或收缩其内容。

引入

  1. import Vue from 'vue';
  2. import { Collapse, CollapseItem } from 'vant';
  3. Vue.use(Collapse);
  4. Vue.use(CollapseItem);

代码演示

基础用法

通过 v-model 控制展开的面板列表,activeNames 为数组格式。

  1. <van-collapse v-model="activeNames">
  2. <van-collapse-item title="标题1" name="1">内容</van-collapse-item>
  3. <van-collapse-item title="标题2" name="2">内容</van-collapse-item>
  4. <van-collapse-item title="标题3" name="3">内容</van-collapse-item>
  5. </van-collapse>
  1. export default {
  2. data() {
  3. return {
  4. activeNames: ['1'],
  5. };
  6. },
  7. };

手风琴

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

  1. <van-collapse v-model="activeName" accordion>
  2. <van-collapse-item title="标题1" name="1">内容</van-collapse-item>
  3. <van-collapse-item title="标题2" name="2">内容</van-collapse-item>
  4. <van-collapse-item title="标题3" name="3">内容</van-collapse-item>
  5. </van-collapse>
  1. export default {
  2. data() {
  3. return {
  4. activeName: '1',
  5. };
  6. },
  7. };

禁用状态

通过 disabled 属性来禁用单个面板。

  1. <van-collapse v-model="activeNames">
  2. <van-collapse-item title="标题1" name="1">内容</van-collapse-item>
  3. <van-collapse-item title="标题2" name="2" disabled>内容</van-collapse-item>
  4. <van-collapse-item title="标题3" name="3" disabled>内容</van-collapse-item>
  5. </van-collapse>

自定义标题内容

通过 title 插槽可以自定义标题栏的内容。

  1. <van-collapse v-model="activeNames">
  2. <van-collapse-item name="1">
  3. <template #title>
  4. <div>标题1 <van-icon name="question-o" /></div>
  5. </template>
  6. 内容
  7. </van-collapse-item>
  8. <van-collapse-item title="标题2" name="2" icon="shop-o">
  9. 内容
  10. </van-collapse-item>
  11. </van-collapse>
  1. export default {
  2. data() {
  3. return {
  4. activeNames: ['1'],
  5. };
  6. },
  7. };

API

Collapse Props

参数说明类型默认值
v-model当前展开面板的 name手风琴模式:number | string
非手风琴模式:(number | string)[]
-
accordion是否开启手风琴模式booleanfalse
border是否显示外边框booleantrue

Collapse Events

事件名说明回调参数
change切换面板时触发activeNames: 类型与 v-model 绑定的值一致

CollapseItem Props

参数说明类型默认值
name唯一标识符,默认为索引值number | stringindex
icon标题栏左侧图标名称或图片链接string-
size标题栏大小,可选值为 largestring-
title标题栏左侧内容number | string-
value标题栏右侧内容number | string-
label标题栏描述信息number | string-
border是否显示内边框booleantrue
is-link是否展示标题栏右侧箭头并开启点击反馈booleantrue
disabled是否禁用面板booleanfalse
title-class左侧标题额外类名string-
value-class右侧内容额外类名string-
label-class描述信息额外类名string-

CollapseItem Slots

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

CollapseItem 方法

通过 ref 可以获取到 CollapseItem 实例并调用实例方法,详见组件实例方法

方法名说明参数返回值
toggle v2.10.9切换面试展开状态,传 true 为展开,false 为收起,不传参为切换expand?: boolean-

样式变量

组件提供了下列 Less 变量,可用于自定义样式,使用方法请参考主题定制

名称默认值描述
@collapse-item-transition-duration@animation-duration-base-
@collapse-item-content-padding@padding-sm @padding-md-
@collapse-item-content-font-size@font-size-md-
@collapse-item-content-line-height1.5-
@collapse-item-content-text-color@gray-6-
@collapse-item-content-background-color@white-
@collapse-item-title-disabled-color@gray-5-

Collapse 折叠面板 - 图1