pco/app/uview-ui/components/u-collapse-item/u-collapse-item.vue

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