uniapp组件库中Collapse 折叠面板 的使用方法

目录

#平台差异说明

#基本使用

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

#自定义样式

#1. 如果修改展开后的内容？

#2. 如何自定义标题的样式？

#3. 如何修改整个Item的样式？

#API

#Collapse Props

#Collapse Item Props

#Collapse Event

#Collapse Item Event

#Collapse Methods

#Slot

---

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

#平台差异说明

App	H5	微信小程序	支付宝小程序	百度小程序	头条小程序	QQ小程序
√	√	√	√	√	√	√

#基本使用

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

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

• 设置u-collapse-item的open参数为true，可以让面板初始化时为打开状态
• 如果设置u-collapse-item的disabled参数为true，那么面板会保持初始状态，无法关闭或打开

#自定义样式

在此组件中，可以通过多个方式对每个Item进行样式定义，我们可以从如下方面思考和着手：

#1. 如果修改展开后的内容？

• 因为是通过默认的slot传入的(见上方示例)，我们可以加一个view元素当做外层，在父组件给它添加样式，如下：

• 通过Collapse的body-style参数也可以配置主体内容的样式，需要注意上面的自定义slot内容如果在父组件定义了样式，会优先起作用。

#2. 如何自定义标题的样式？

如果想修改头部标题的字体大小，颜色等，可以通过head-style参数修改。

#3. 如何修改整个Item的样式？

有时候我们需要修改Item的整体样式，比如将各个Item之间隔开，这时我们可以通过item-style参数进行设置，比如：

#API

#Collapse Props

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

#Collapse Item Props

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

#Collapse Event

注意：请在上监听此事件

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

#Collapse Item Event

注意：请在上监听此事件

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

#Collapse Methods

注意：此方法需要通过ref调用

方法	说明
init 1.3.8	重新初始化内部高度计算，用于异步获取内容的情形，请结合this.$nextTick()使用

#Slot

名称	说明
-	主体部分的内容
title 1.3.5	头部的内容，不含右边的箭头
title-all 1.3.5	整个头部的内容，包含右边的箭头