<template>
|
<view class="u-collapse-item">
|
<u-cell
|
:title="title"
|
:value="value"
|
:label="label"
|
:icon="icon"
|
:isLink="isLink"
|
:clickable="clickable"
|
:border="parentData.border && showBorder"
|
@click="clickHandler"
|
:arrowDirection="expanded ? 'up' : 'down'"
|
:disabled="disabled"
|
>
|
<!-- #ifndef MP-WEIXIN -->
|
<!-- 微信小程序不支持，因为微信中不支持 <slot name="title" slot="title" />的写法 -->
|
<template slot="title">
|
<slot name="title"></slot>
|
</template>
|
<template slot="icon">
|
<slot name="icon"></slot>
|
</template>
|
<template slot="value">
|
<slot name="value"></slot>
|
</template>
|
<template slot="right-icon">
|
<slot name="right-icon"></slot>
|
</template>
|
<!-- #endif -->
|
</u-cell>
|
<view
|
class="u-collapse-item__content"
|
:animation="animationData"
|
ref="animation"
|
>
|
<view
|
class="u-collapse-item__content__text content-class"
|
:id="elId"
|
:ref="elId"
|
><slot /></view>
|
</view>
|
<u-line v-if="parentData.border"></u-line>
|
</view>
|
</template>
|
|
<script>
|
import props from './props.js';
|
// #ifdef APP-NVUE
|
const animation = uni.requireNativePlugin('animation')
|
const dom = uni.requireNativePlugin('dom')
|
// #endif
|
/**
|
* collapseItem 折叠面板Item
|
* @description 通过折叠面板收纳内容区域（搭配u-collapse使用）
|
* @tutorial https://www.uviewui.com/components/collapse.html
|
* @property {String} title 标题
|
* @property {String} value 标题右侧内容
|
* @property {String} label 标题下方的描述信息
|
* @property {Boolean} disbled 是否禁用折叠面板 ( 默认 false )
|
* @property {Boolean} isLink 是否展示右侧箭头并开启点击反馈 ( 默认 true )
|
* @property {Boolean} clickable 是否开启点击反馈 ( 默认 true )
|
* @property {Boolean} border 是否显示内边框 ( 默认 true )
|
* @property {String} align 标题的对齐方式 ( 默认 'left' )
|
* @property {String | Number} name 唯一标识符
|
* @property {String} icon 标题左侧图片，可为绝对路径的图片或内置图标
|
* @event {Function} change 某个item被打开或者收起时触发
|
* @example <u-collapse-item :title="item.head" v-for="(item, index) in itemList" :key="index">{{item.body}}</u-collapse-item>
|
*/
|
export default {
|
name: "u-collapse-item",
|
mixins: [uni.$u.mpMixin, uni.$u.mixin, props],
|
data() {
|
return {
|
elId: uni.$u.guid(),
|
// uni.createAnimation的导出数据
|
animationData: {},
|
// 是否展开状态
|
expanded: false,
|
// 根据expanded确定是否显示border，为了控制展开时，cell的下划线更好的显示效果，进行一定时间的延时
|
showBorder: false,
|
// 是否动画中，如果是则不允许继续触发点击
|
animating: false,
|
// 父组件u-collapse的参数
|
parentData: {
|
accordion: false,
|
border: false
|
}
|
};
|
},
|
watch: {
|
expanded(n) {
|
clearTimeout(this.timer)
|
this.timer = null
|
// 这里根据expanded的值来进行一定的延时，是为了cell的下划线更好的显示效果
|
this.timer = setTimeout(() => {
|
this.showBorder = n
|
}, n ? 10 : 290)
|
}
|
},
|
mounted() {
|
this.init()
|
},
|
methods: {
|
// 异步获取内容，或者动态修改了内容时，需要重新初始化
|
init() {
|
// 初始化数据
|
this.updateParentData()
|
if (!this.parent) {
|
return uni.$u.error('u-collapse-item必须要搭配u-collapse组件使用')
|
}
|
const {
|
value,
|
accordion,
|
children = []
|
} = this.parent
|
|
if (accordion) {
|
if (uni.$u.test.array(value)) {
|
return uni.$u.error('手风琴模式下，u-collapse组件的value参数不能为数组')
|
}
|
this.expanded = this.name == value
|
} else {
|
if (!uni.$u.test.array(value) && value !== null) {
|
return uni.$u.error('非手风琴模式下，u-collapse组件的value参数必须为数组')
|
}
|
this.expanded = (value || []).some(item => item == this.name)
|
}
|
// 设置组件的展开或收起状态
|
this.$nextTick(function() {
|
this.setContentAnimate()
|
})
|
},
|
updateParentData() {
|
// 此方法在mixin中
|
this.getParentData('u-collapse')
|
},
|
async setContentAnimate() {
|
// 每次面板打开或者收起时，都查询元素尺寸
|
// 好处是，父组件从服务端获取内容后，变更折叠面板后可以获得最新的高度
|
const rect = await this.queryRect()
|
const height = this.expanded ? rect.height : 0
|
this.animating = true
|
// #ifdef APP-NVUE
|
const ref = this.$refs['animation'].ref
|
animation.transition(ref, {
|
styles: {
|
height: height + 'px'
|
},
|
duration: this.duration,
|
// 必须设置为true，否则会到面板收起或展开时，页面其他元素不会随之调整它们的布局
|
needLayout: true,
|
timingFunction: 'ease-in-out',
|
}, () => {
|
this.animating = false
|
})
|
// #endif
|
|
// #ifndef APP-NVUE
|
const animation = uni.createAnimation({
|
timingFunction: 'ease-in-out',
|
});
|
animation
|
.height(height)
|
.step({
|
duration: this.duration,
|
})
|
.step()
|
// 导出动画数据给面板的animationData值
|
this.animationData = animation.export()
|
// 标识动画结束
|
uni.$u.sleep(this.duration).then(() => {
|
this.animating = false
|
})
|
// #endif
|
},
|
// 点击collapsehead头部
|
clickHandler() {
|
if (this.disabled && this.animating) return
|
// 设置本组件为相反的状态
|
this.parent && this.parent.onChange(this)
|
},
|
// 查询内容高度
|
queryRect() {
|
// #ifndef APP-NVUE
|
// $uGetRect为uView自带的节点查询简化方法，详见文档介绍：https://www.uviewui.com/js/getRect.html
|
// 组件内部一般用this.$uGetRect，对外的为uni.$u.getRect，二者功能一致，名称不同
|
return new Promise(resolve => {
|
this.$uGetRect(`#${this.elId}`).then(size => {
|
resolve(size)
|
})
|
})
|
// #endif
|
|
// #ifdef APP-NVUE
|
// nvue下，使用dom模块查询元素高度
|
// 返回一个promise，让调用此方法的主体能使用then回调
|
return new Promise(resolve => {
|
dom.getComponentRect(this.$refs[this.elId], res => {
|
resolve(res.size)
|
})
|
})
|
// #endif
|
}
|
},
|
};
|
</script>
|
|
<style lang="scss" scoped>
|
@import "../../libs/css/components.scss";
|
|
.u-collapse-item {
|
|
&__content {
|
overflow: hidden;
|
height: 0;
|
|
&__text {
|
padding: 12px 15px;
|
color: $u-content-color;
|
font-size: 14px;
|
line-height: 18px;
|
}
|
}
|
}
|
</style>
|
