quanyawei
2023-10-20 d8b41fff43a2cee6a8f714ffa807623b15803786
uni_modules/uview-ui/components/u-collapse-item/u-collapse-item.vue
New file
@@ -0,0 +1,225 @@
<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>