New file |
| | |
| | | <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> |