# Collapse 折叠面板
# 使用指南
import Collapse from '@hips/uni-ui/lib/collapse';
import CollapseItem from '@hips/uni-ui/lib/collapse-item';
export default {
components: {
'hips-collapse': Collapse,
'hips-collapse-item': CollapseItem,
},
};
1
2
3
4
5
6
7
8
9
2
3
4
5
6
7
8
9
# 跨平台支持
微信小程序 | 支付宝小程序 | 钉钉小程序 | 百度小程序 | 头条小程序 | QQ 小程序 |
---|---|---|---|---|---|
✔️ | - | - | - | - | - |
# 代码演示
# 基础用法
<hips-collapse v-model="activeNames">
<hips-collapse-item title="折叠面板" name="1">
面板内容...
</hips-collapse-item>
</hips-collapse>
1
2
3
4
5
2
3
4
5
export default {
data() {
return {
activeNames: ['1'],
};
},
};
1
2
3
4
5
6
7
2
3
4
5
6
7
# 手风琴
<hips-collapse v-model="activeName" accordion>
<hips-collapse-item title="折叠面板1" name="1">
面板内容...
</hips-collapse-item>
<hips-collapse-item title="折叠面板2" name="2">
面板内容...
</hips-collapse-item>
</hips-collapse>
1
2
3
4
5
6
7
8
2
3
4
5
6
7
8
export default {
data() {
return {
activeName: '1',
};
},
};
1
2
3
4
5
6
7
2
3
4
5
6
7
注意
v-model 绑定的对象,当是普通模式时,是一个数字或者字符串数组
,当是手风琴模式时,是一个纯数字或者字符串。
# 自定义标题内容
<hips-collapse v-model="activeNames">
<hips-collapse-item name="1">
<div slot="title">折叠面板1<hips-icon name="question" /></div>
面板内容...
</hips-collapse-item>
<hips-collapse-item title="面板标题" name="2">
面板内容...
</hips-collapse-item>
</hips-collapse>
1
2
3
4
5
6
7
8
9
2
3
4
5
6
7
8
9
# Collapse API
参数 | 说明 | 类型 | 默认值 |
---|---|---|---|
v-model | 当前展开面板的 name | Array | String | Number | - |
accordion | 是否开启手风琴模式 | Boolean | false |
# Collapse Event
事件名 | 说明 | 参数 | 类型 |
---|---|---|---|
change | 切换面板时触发 | activeNames | string | array |
# CollapseItem API
参数 | 说明 | 类型 | 默认值 |
---|---|---|---|
name | 面板唯一标识符,默认为索引值 | String | Number | index (数字) |
disabled | 是否禁用面板 | Boolean | false |
icon | 左侧图标,可选值见 Icon 组件 | String | - |
title | 左侧标题 | String | Number | - |
show-animation | 是否有展开关闭动画 | Boolean | true |
# CollapseItem Slot
名称 | 说明 |
---|---|
- | 面板内容 |
icon | 自定义icon |
title | 自定义title |
right-icon | 自定义右侧按钮,默认是arrow |
# 样式变量
变量名 | 说明 | 默认值 |
---|---|---|
collapse-border-color | 边框颜色 | #EEEEEE |
collapse-item-title-color | item 标题颜色 | #6D7A80 |
collapse-item-title-font-size | item 标题文字大小 | 32rpx |
collapse-item-title-bg-color | item 标题背景颜色 | white |
collapse-item-title-height | item 标题高度 | 100rpx |
collapse-item-title-padding-right | item 标题距离右边 padding | 30rpx |
collapse-item-left-icon-size | item 顶部左侧图标容器高度 | 60rpx |
collapse-item-left-icon-padding-right | item 顶部左侧图标容器右边 padding | 20rpx |
collapse-item-content-bg-color | item 内容背景颜色 | white |
注意
样式变量默认前缀为 $
可以通过 @hips/ui-stylus-loader 进行修改变量