pco/app/uview-ui/components/u-skeleton/u-skeleton.vue

<template>
  <view class="u-skeleton">
    <view
        class="u-skeleton__wrapper"
        ref="u-skeleton__wrapper"
        v-if="loading"
        style="display: flex; flex-direction: row;"
    >
      <view
          class="u-skeleton__wrapper__avatar"
          v-if="avatar"
          :class="[`u-skeleton__wrapper__avatar--${avatarShape}`, animate && 'animate']"
          :style="{
						height: $u.addUnit(avatarSize),
						width: $u.addUnit(avatarSize)
					}"
      ></view>
      <view
          class="u-skeleton__wrapper__content"
          ref="u-skeleton__wrapper__content"
          style="flex: 1;"
      >
        <view
            class="u-skeleton__wrapper__content__title"
            v-if="title"
            :style="{
							width: uTitleWidth,
							height: $u.addUnit(titleHeight),
						}"
            :class="[animate && 'animate']"
        ></view>
        <view
            class="u-skeleton__wrapper__content__rows"
            :class="[animate && 'animate']"
            v-for="(item, index) in rowsArray"
            :key="index"
            :style="{
							 width: item.width,
							 height: item.height,
							 marginTop: item.marginTop
						}"
        >

        </view>
      </view>
    </view>
    <slot v-else/>
  </view>
</template>

<script>
import props from './props.js';
// #ifdef APP-NVUE
// 由于weex为阿里的KPI业绩考核的产物，所以不支持百分比单位，这里需要通过dom查询组件的宽度
const dom = uni.requireNativePlugin('dom')
const animation = uni.requireNativePlugin('animation')
// #endif
/**
 * Skeleton 骨架屏
 * @description 骨架屏一般用于页面在请求远程数据尚未完成时，页面用灰色块预显示本来的页面结构，给用户更好的体验。
 * @tutorial https://www.uviewui.com/components/skeleton.html
 * @property {Boolean}          loading    是否显示骨架占位图，设置为false将会展示子组件内容 (默认 true )
 * @property {Boolean}          animate    是否开启动画效果 (默认 true )
 * @property {String | Number}      rows    段落占位图行数 (默认 0 )
 * @property {String | Number | Array}  rowsWidth  段落占位图的宽度，可以为百分比，数值，带单位字符串等，可通过数组传入指定每个段落行的宽度 (默认 '100%' )
 * @property {String | Number | Array}  rowsHeight  段落的高度 (默认 18 )
 * @property {Boolean}          title    是否展示标题占位图 (默认 true )
 * @property {String | Number}      titleWidth  标题的宽度 (默认 '50%' )
 * @property {String | Number}      titleHeight  标题的高度 (默认 18 )
 * @property {Boolean}          avatar    是否展示头像占位图 (默认 false )
 * @property {String | Number}      avatarSize  头像占位图大小 (默认 32 )
 * @property {String}          avatarShape  头像占位图的形状，circle-圆形，square-方形 (默认 'circle' )
 * @example <u-search placeholder="日照香炉生紫烟" v-model="keyword"></u-search>
 */
export default {
  name: 'u-skeleton',
  mixins: [uni.$u.mpMixin, uni.$u.mixin, props],
  data() {
    return {
      width: 0,
    }
  },
  watch: {
    loading() {
      this.getComponentWidth()
    }
  },
  computed: {
    rowsArray() {
      if (/%$/.test(this.rowsHeight)) {
        uni.$u.error('rowsHeight参数不支持百分比单位')
      }
      const rows = []
      for (let i = 0; i < this.rows; i++) {
        let item = {},
            // 需要预防超出数组边界的情况
            rowWidth = uni.$u.test.array(this.rowsWidth) ? (this.rowsWidth[i] || (i === this.row - 1 ? '70%' : '100%')) : i ===
            this.rows - 1 ? '70%' : this.rowsWidth,
            rowHeight = uni.$u.test.array(this.rowsHeight) ? (this.rowsHeight[i] || '18px') : this.rowsHeight
        // 如果有title占位图，第一个段落占位图的外边距需要大一些，如果没有title占位图，第一个段落占位图则无需外边距
        // 之所以需要这么做，是因为weex的无能，以提升性能为借口不支持css的一些伪类
        item.marginTop = !this.title && i === 0 ? 0 : this.title && i === 0 ? '20px' : '12px'
        // 如果设置的为百分比的宽度，转换为px值，因为nvue不支持百分比单位
        if (/%$/.test(rowWidth)) {
          // 通过parseInt提取出百分比单位中的数值部分，除以100得到百分比的小数值
          item.width = uni.$u.addUnit(this.width * parseInt(rowWidth) / 100)
        } else {
          item.width = uni.$u.addUnit(rowWidth)
        }
        item.height = uni.$u.addUnit(rowHeight)
        rows.push(item)
      }
      // console.log(rows);
      return rows
    },
    uTitleWidth() {
      let tWidth = 0
      if (/%$/.test(this.titleWidth)) {
        // 通过parseInt提取出百分比单位中的数值部分，除以100得到百分比的小数值
        tWidth = uni.$u.addUnit(this.width * parseInt(this.titleWidth) / 100)
      } else {
        tWidth = uni.$u.addUnit(this.titleWidth)
      }
      return uni.$u.addUnit(tWidth)
    },

  },
  mounted() {
    this.init()
  },
  methods: {
    init() {
      this.getComponentWidth()
      // #ifdef APP-NVUE
      this.loading && this.animate && this.setNvueAnimation()
      // #endif
    },
    async setNvueAnimation() {
      // #ifdef APP-NVUE
      // 为了让opacity:1的状态保持一定时间，这里做一个延时
      await uni.$u.sleep(500)
      const skeleton = this.$refs['u-skeleton__wrapper'];
      skeleton && this.loading && this.animate && animation.transition(skeleton, {
        styles: {
          opacity: 0.5
        },
        duration: 600,
      }, () => {
        // 这里无需判断是否loading和开启动画状态，因为最终的状态必须达到opacity: 1，否则可能
        // 会停留在opacity: 0.5的状态中
        animation.transition(skeleton, {
          styles: {
            opacity: 1
          },
          duration: 600,
        }, () => {
          // 只有在loading中时，才执行动画
          this.loading && this.animate && this.setNvueAnimation()
        })
      })
      // #endif
    },
    // 获取组件的宽度
    async getComponentWidth() {
      // 延时一定时间，以获取dom尺寸
      await uni.$u.sleep(20)
      // #ifndef APP-NVUE
      this.$uGetRect('.u-skeleton__wrapper__content').then(size => {
        this.width = size.width
      })
      // #endif

      // #ifdef APP-NVUE
      const ref = this.$refs['u-skeleton__wrapper__content']
      ref && dom.getComponentRect(ref, (res) => {
        this.width = res.size.width
      })
      // #endif
    }
  }
}
</script>

<style lang="scss" scoped>
@import "../../libs/css/components.scss";

@mixin background {
  /* #ifdef APP-NVUE */
  background-color: #F1F2F4;
  /* #endif */
  /* #ifndef APP-NVUE */
  background: linear-gradient(90deg, #F1F2F4 25%, #e6e6e6 37%, #F1F2F4 50%);
  background-size: 400% 100%;
  /* #endif */
}

.u-skeleton {
  flex: 1;

  &__wrapper {
    @include flex(row);

    &__avatar {
      @include background;
      margin-right: 15px;

      &--circle {
        border-radius: 100px;
      }

      &--square {
        border-radius: 4px;
      }
    }

    &__content {
      flex: 1;

      &__rows,
      &__title {
        @include background;
        border-radius: 3px;
      }
    }
  }
}

/* #ifndef APP-NVUE */
.animate {
  animation: skeleton 1.8s ease infinite
}

@keyframes skeleton {
  0% {
    background-position: 100% 50%
  }

  100% {
    background-position: 0 50%
  }
}

/* #endif */
</style>