Collapse 折叠面板

通过折叠面板收纳内容区域

平台差异说明

AppH5微信小程序支付宝小程序百度小程序头条小程序QQ小程序

基本使用

默认为手风琴模式,即打开一个,另外所有的都会关闭。可以将u-collapseaccordion设置为false,这样可以允许打开多个面板

  1. <template>
  2. <u-collapse>
  3. <u-collapse-item :title="item.head" v-for="(item, index) in itemList" :key="index">
  4. {{item.body}}
  5. </u-collapse-item>
  6. </u-collapse>
  7. </template>
  8. <script>
  9. export default {
  10. data() {
  11. return {
  12. itemList: [{
  13. head: "赏识在于角度的转换",
  14. body: "只要我们正确择取一个合适的参照物乃至稍降一格去看待他人,值得赏识的东西便会扑面而来",
  15. open: true,
  16. disabled: true
  17. },{
  18. head: "生活中不是缺少美,而是缺少发现美的眼睛",
  19. body: "学会欣赏,实际是一种积极生活的态度,是生活的调味品,会在欣赏中发现生活的美",
  20. open: false,
  21. },{
  22. head: "周围一些不起眼的人、事、物,或许都隐藏着不同凡响的智慧",
  23. body: "但是据说雕刻大卫像所用的这块大理石,曾被多位雕刻家批评得一无是处,有些人认为这块大理石采凿得不好,有些人嫌它的纹路不够美",
  24. open: false,
  25. }],
  26. }
  27. }
  28. }
  29. </script>

控制面板的初始状态,以及是否可以操作

  • 设置u-collapse-itemopen参数为true,可以让面板初始化时为打开状态
  • 如果设置u-collapse-itemdisabled参数为true,那么面板会保持初始状态,无法关闭或打开
  1. <template>
  2. <u-collapse>
  3. <u-collapse-item :title="item.head" v-for="(item, index) in itemList" :key="index" :open="item.open" :disabled="item.disabled">
  4. {{item.body}}
  5. </u-collapse-item>
  6. </u-collapse>
  7. </template>
  8. <script>
  9. export default {
  10. data() {
  11. return {
  12. itemList: [{
  13. head: "赏识在于角度的转换",
  14. body: "只要我们正确择取一个合适的参照物乃至稍降一格去看待他人,值得赏识的东西便会扑面而来",
  15. open: true,
  16. disabled: true
  17. },{
  18. head: "生活中不是缺少美,而是缺少发现美的眼睛",
  19. body: "学会欣赏,实际是一种积极生活的态度,是生活的调味品,会在欣赏中发现生活的美",
  20. open: false,
  21. },{
  22. head: "周围一些不起眼的人、事、物,或许都隐藏着不同凡响的智慧",
  23. body: "但是据说雕刻大卫像所用的这块大理石,曾被多位雕刻家批评得一无是处,有些人认为这块大理石采凿得不好,有些人嫌它的纹路不够美",
  24. open: false,
  25. }],
  26. }
  27. }
  28. }
  29. </script>

API

Collapse Props

参数说明类型默认值可选值
accordion是否手风琴模式Booleantruefalse
arrow是否显示标题右侧的箭头Booleantruefalse
arrow-color标题右侧箭头的颜色String#909399-
head-style标题自定义样式,对象形式Object--
body-style主体自定义样式,对象形式Object--
hover-class样式类名,按下时有效,样式必须写在根目录的App.vue或通过其引入的全局样式中才有效,none为无效果,作用于头部标题区域Stringu-hover-classnone / 其他

Collapse Item Props

参数说明类型默认值可选值
title面板标题String--
index主要用于事件的回调,标识那个Item被点击String / Number--
disabled面板是否可以打开或收起Booleanfalsetrue
open设置某个面板的初始状态是否打开Booleanfalsetrue
name唯一标识符,如不设置,默认用当前collapse-item的索引值String / Number--
align标题的对齐方式Stringleft-
active-style不显示箭头时,可以添加当前选择的collapse-item活动样式,对象形式Object--

Collapse Event

注意:请在<u-collapse></u-collapse>上监听此事件

事件名说明回调参数
change当前激活面板展开时触发(如果是手风琴模式,参数activeNames类型为String,否则为Array)activeNames: String / Array

Collapse Item Event

注意:请在<u-collapse-item></u-collapse-item>上监听此事件

事件名说明回调参数
change某个item被打开或者收起时触发对象,{index: index, show: true | false },index为collapse-itemindex参数,show为true表示被打开,false表示被收起