Collapse 折叠面板

引入

通过以下方式来全局注册组件,更多注册方式请参考。

基础用法

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

  1. <van-collapse v-model="activeNames">
  2. <van-collapse-item title="标题1" name="1">
  3. 代码是写出来给人看的,附带能在机器上运行。
  4. </van-collapse-item>
  5. <van-collapse-item title="标题2" name="2">
  6. </van-collapse-item>
  7. <van-collapse-item title="标题3" name="3">
  8. 在代码阅读过程中人们说脏话的频率是衡量代码质量的唯一标准。
  9. </van-collapse-item>
  10. </van-collapse>
  1. import { ref } from 'vue';
  2. export default {
  3. setup() {
  4. const activeNames = ref(['1']);
  5. return { activeNames };
  6. },
  7. };

手风琴

  1. import { ref } from 'vue';
  2. export default {
  3. setup() {
  4. const activeName = ref('1');
  5. return { activeName };
  6. },
  7. };

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

  1. <van-collapse-item title="标题1" name="1">
  2. 代码是写出来给人看的,附带能在机器上运行。
  3. </van-collapse-item>
  4. <van-collapse-item title="标题2" name="2" disabled>
  5. 技术无非就是那些开发它的人的共同灵魂。
  6. </van-collapse-item>
  7. <van-collapse-item title="标题3" name="3" disabled>
  8. 在代码阅读过程中人们说脏话的频率是衡量代码质量的唯一标准。
  9. </van-collapse-item>
  10. </van-collapse>

自定义标题内容

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

  1. import { ref } from 'vue';
  2. export default {
  3. setup() {
  4. return { activeNames };
  5. },
  6. };

Collapse Props

Collapse Events

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

CollapseItem 方法

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

类型定义

组件导出以下类型定义:

  1. import type {
  2. CollapseProps,
  3. CollapseItemProps,
  4. } from 'vant';

CollapseItemInstance 是组件实例的类型,用法如下:

CollapseItem Slots

名称默认值描述
—van-collapse-item-transition-durationvar(—van-animation-duration-base)-
—van-collapse-item-content-paddingvar(—van-padding-sm) var(—van-padding-md)-
—van-collapse-item-content-font-sizevar(—van-font-size-md)-
—van-collapse-item-content-line-height1.5-
—van-collapse-item-content-text-colorvar(—van-text-color-2)-
—van-collapse-item-content-background-colorvar(—van-background-color-light)-
—van-collapse-item-title-disabled-colorvar(—van-text-color-3)-