@ophiuchus/collapse v1.0.1

Collapse 折叠面板

介绍

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

引入

// 方式1（推荐）
import Vue from 'vue';
import Collapse from '@ophiuchus/collapse';

Vue.use(Collapse);

// 方式2
import Vue from 'vue';
import { Collapse, CollapseItem } from '@ophiuchus/collapse';

Vue.component(Collapse.name, Collapse);
Vue.component(CollapseItem.name, CollapseItem);

代码演示

基础用法

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

<sf-collapse v-model="activeNames">
  <sf-collapse-item title="标题1" name="1">内容</sf-collapse-item>
  <sf-collapse-item title="标题2" name="2">内容</sf-collapse-item>
  <sf-collapse-item title="标题3" name="3">内容</sf-collapse-item>
</sf-collapse>

export default {
  data() {
    return {
      activeNames: ['1'],
    };
  },
};

手风琴

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

<sf-collapse v-model="activeName" accordion>
  <sf-collapse-item title="标题1" name="1">内容</sf-collapse-item>
  <sf-collapse-item title="标题2" name="2">内容</sf-collapse-item>
  <sf-collapse-item title="标题3" name="3">内容</sf-collapse-item>
</sf-collapse>

export default {
  data() {
    return {
      activeName: '1',
    };
  },
};

禁用状态

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

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

自定义标题内容

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

<sf-collapse v-model="activeNames">
  <sf-collapse-item name="1">
    <template #title>
      <div>标题1 <sf-icon name="question-o" /></div>
    </template>
    内容
  </sf-collapse-item>
  <sf-collapse-item title="标题2" name="2" icon="location-o">
    内容
  </sf-collapse-item>
</sf-collapse>

export default {
  data() {
    return {
      activeNames: ['1'],
    };
  },
};

API

Collapse Props

Collapse Events

CollapseItem Props

CollapseItem Slots

CollapseItem 方法

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

样式变量

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