折叠面板组件,包含:
uni-collapse:父容器uni-collapse-item:子面板
一个折叠面板组件可以包含若干uni-collapse-item。每个uni-collapse-item包括顶部标题栏和通过slot传入的内容区。
基本用法
<uni-collapse :accordion="true">
<uni-collapse-item title="标题 1" :open="true">
<view><text>内容 1</text></view>
</uni-collapse-item>
<uni-collapse-item title="标题 2">
<view><text>内容 2</text></view>
</uni-collapse-item>
</uni-collapse>
uni-collapse-item的标题栏的自定义:
- 标题栏容器可通过
title-wrap-class自定义背景等容器样式。 - 标题栏支持title属性,可通过title-class自定义文字样式。
- 标题展开态可通过
title-open-class自定义激活文字样式。组件默认使用透明度区分状态,便于外部继续覆盖文字颜色。 - 标题禁用态可通过
title-disabled-class自定义禁用文字样式。若同时存在展开态和禁用态,以禁用态为最终状态。 - 内容外层容器可通过
content-wrap-class自定义背景等容器样式。 - 标题栏右边默认带有箭头,可通过arrow-class自定义箭头样式。该箭头为一个view包括2个直角边的边框,然后旋转而成。
- 箭头展开态和禁用态可分别通过
arrow-open-class、arrow-disabled-class覆盖。组件默认也使用透明度区分状态,便于外部继续覆盖箭头颜色。 - 如果完全不想要默认包含的title和arrow,也可以传入一个名为title的具名插槽来替换。
具名插槽标题
<uni-collapse-item>
<template #title="{ open, disabled }">
<view class="custom-title">
<view class="custom-title-icon"></view>
<text class="custom-title-text">{{ open ? '已展开' : '未展开' }}</text>
</view>
</template>
<view><text>自定义标题内容</text></view>
</uni-collapse-item>
externalClass
<uni-collapse-item
title="自定义样式"
title-wrap-class="my-title-wrap-class"
title-class="my-title-class"
title-open-class="my-title-open-class"
content-wrap-class="my-content-wrap-class"
arrow-class="my-arrow-class"
arrow-open-class="my-arrow-open-class"
>
<view><text>内容区域</text></view>
</uni-collapse-item>
Slots
uni-collapse-item
| 插槽名 | 说明 | 插槽参数 |
|---|---|---|
| default | 面板内容 | - |
| title | 自定义标题区域 | open: boolean、disabled: boolean |
Events
uni-collapse-item
| 事件名 | 说明 | 回调参数 |
|---|---|---|
| change | 面板展开状态变化时触发 | open: boolean |
Expose
uni-collapse-item
| 方法名 | 说明 |
|---|---|
| openCollapse(open: boolean) | 执行展开/收起,会遵循 disabled 和手风琴逻辑 |
| openOrClose(open: boolean) | 直接切换内容显示状态 |
暗黑模式适配
建议通过组件 class 和 externalClass 组合传入暗色样式:
- 用组件
class统一控制根节点和内容区等外层视觉。 - 用
title-wrap-class、title-class、title-open-class、content-wrap-class、arrow-class、arrow-open-class等 externalClass 覆盖标题区、内容外层和箭头样式。 - 默认展开态和禁用态主要通过透明度表达,减少颜色覆盖时的交叉冲突。
注意
- 本组件在Android上需HBuilderX 5.09+。在低版本上箭头变颜色+旋转时,在Android上会消失