u-image.vue 8.1 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235
  1. <template>
  2. <u-transition
  3. mode="fade"
  4. :show="show"
  5. :duration="fade ? 1000 : 0"
  6. >
  7. <view
  8. class="u-image"
  9. @tap="onClick"
  10. :style="[wrapStyle, backgroundStyle]"
  11. >
  12. <image
  13. v-if="!isError"
  14. :src="src"
  15. :mode="mode"
  16. @error="onErrorHandler"
  17. @load="onLoadHandler"
  18. :show-menu-by-longpress="showMenuByLongpress"
  19. :lazy-load="lazyLoad"
  20. class="u-image__image"
  21. :style="{
  22. borderRadius: shape == 'circle' ? '10000px' : $u.addUnit(radius),
  23. width: $u.addUnit(width),
  24. height: $u.addUnit(height)
  25. }"
  26. ></image>
  27. <view
  28. v-if="showLoading && loading"
  29. class="u-image__loading"
  30. :style="{
  31. borderRadius: shape == 'circle' ? '50%' : $u.addUnit(radius),
  32. backgroundColor: this.bgColor,
  33. width: $u.addUnit(width),
  34. height: $u.addUnit(height)
  35. }"
  36. >
  37. <slot name="loading">
  38. <u-icon
  39. :name="loadingIcon"
  40. :width="width"
  41. :height="height"
  42. ></u-icon>
  43. </slot>
  44. </view>
  45. <view
  46. v-if="showError && isError && !loading"
  47. class="u-image__error"
  48. :style="{
  49. borderRadius: shape == 'circle' ? '50%' : $u.addUnit(radius),
  50. width: $u.addUnit(width),
  51. height: $u.addUnit(height)
  52. }"
  53. >
  54. <slot name="error">
  55. <u-icon
  56. :name="errorIcon"
  57. :width="width"
  58. :height="height"
  59. ></u-icon>
  60. </slot>
  61. </view>
  62. </view>
  63. </u-transition>
  64. </template>
  65. <script>
  66. import props from './props.js';
  67. import mpMixin from '../../libs/mixin/mpMixin.js';
  68. import mixin from '../../libs/mixin/mixin.js';
  69. /**
  70. * Image 图片
  71. * @description 此组件为uni-app的image组件的加强版,在继承了原有功能外,还支持淡入动画、加载中、加载失败提示、圆角值和形状等。
  72. * @tutorial https://uiadmin.net/uview-plus/components/image.html
  73. * @property {String} src 图片地址
  74. * @property {String} mode 裁剪模式,见官网说明 (默认 'aspectFill' )
  75. * @property {String | Number} width 宽度,单位任意,如果为数值,则为px单位 (默认 '300' )
  76. * @property {String | Number} height 高度,单位任意,如果为数值,则为px单位 (默认 '225' )
  77. * @property {String} shape 图片形状,circle-圆形,square-方形 (默认 'square' )
  78. * @property {String | Number} radius 圆角值,单位任意,如果为数值,则为px单位 (默认 0 )
  79. * @property {Boolean} lazyLoad 是否懒加载,仅微信小程序、App、百度小程序、字节跳动小程序有效 (默认 true )
  80. * @property {Boolean} showMenuByLongpress 是否开启长按图片显示识别小程序码菜单,仅微信小程序有效 (默认 true )
  81. * @property {String} loadingIcon 加载中的图标,或者小图片 (默认 'photo' )
  82. * @property {String} errorIcon 加载失败的图标,或者小图片 (默认 'error-circle' )
  83. * @property {Boolean} showLoading 是否显示加载中的图标或者自定义的slot (默认 true )
  84. * @property {Boolean} showError 是否显示加载错误的图标或者自定义的slot (默认 true )
  85. * @property {Boolean} fade 是否需要淡入效果 (默认 true )
  86. * @property {Boolean} webp 只支持网络资源,只对微信小程序有效 (默认 false )
  87. * @property {String | Number} duration 搭配fade参数的过渡时间,单位ms (默认 500 )
  88. * @property {String} bgColor 背景颜色,用于深色页面加载图片时,为了和背景色融合 (默认 '#f3f4f6' )
  89. * @property {Object} customStyle 定义需要用到的外部样式
  90. * @event {Function} click 点击图片时触发
  91. * @event {Function} error 图片加载失败时触发
  92. * @event {Function} load 图片加载成功时触发
  93. * @example <u-image width="100%" height="300px" :src="src"></u-image>
  94. */
  95. export default {
  96. name: 'u-image',
  97. mixins: [mpMixin, mixin, props],
  98. data() {
  99. return {
  100. // 图片是否加载错误,如果是,则显示错误占位图
  101. isError: false,
  102. // 初始化组件时,默认为加载中状态
  103. loading: true,
  104. // 不透明度,为了实现淡入淡出的效果
  105. opacity: 1,
  106. // 过渡时间,因为props的值无法修改,故需要一个中间值
  107. durationTime: this.duration,
  108. // 图片加载完成时,去掉背景颜色,因为如果是png图片,就会显示灰色的背景
  109. backgroundStyle: {},
  110. // 用于fade模式的控制组件显示与否
  111. show: false
  112. };
  113. },
  114. watch: {
  115. src: {
  116. immediate: true,
  117. handler(n) {
  118. if (!n) {
  119. // 如果传入null或者'',或者false,或者undefined,标记为错误状态
  120. this.isError = true
  121. } else {
  122. this.isError = false;
  123. this.loading = true;
  124. }
  125. }
  126. }
  127. },
  128. computed: {
  129. wrapStyle() {
  130. let style = {};
  131. // 通过调用addUnit()方法,如果有单位,如百分比,px单位等,直接返回,如果是纯粹的数值,则加上rpx单位
  132. style.width = this.$u.addUnit(this.width);
  133. style.height = this.$u.addUnit(this.height);
  134. // 如果是显示圆形,设置一个很多的半径值即可
  135. style.borderRadius = this.shape == 'circle' ? '10000px' : uni.$u.addUnit(this.radius)
  136. // 如果设置圆角,必须要有hidden,否则可能圆角无效
  137. style.overflow = this.radius > 0 ? 'hidden' : 'visible'
  138. // if (this.fade) {
  139. // style.opacity = this.opacity
  140. // // nvue下,这几个属性必须要分开写
  141. // style.transitionDuration = `${this.durationTime}ms`
  142. // style.transitionTimingFunction = 'ease-in-out'
  143. // style.transitionProperty = 'opacity'
  144. // }
  145. return uni.$u.deepMerge(style, uni.$u.addStyle(this.customStyle));
  146. }
  147. },
  148. mounted() {
  149. this.show = true
  150. },
  151. emits: ['click', 'error', 'load'],
  152. methods: {
  153. // 点击图片
  154. onClick() {
  155. this.$emit('click')
  156. },
  157. // 图片加载失败
  158. onErrorHandler(err) {
  159. this.loading = false
  160. this.isError = true
  161. this.$emit('error', err)
  162. },
  163. // 图片加载完成,标记loading结束
  164. onLoadHandler(event) {
  165. this.loading = false
  166. this.isError = false
  167. this.$emit('load', event)
  168. this.removeBgColor()
  169. // 如果不需要动画效果,就不执行下方代码,同时移除加载时的背景颜色
  170. // 否则无需fade效果时,png图片依然能看到下方的背景色
  171. // if (!this.fade) return this.removeBgColor();
  172. // // 原来opacity为1(不透明,是为了显示占位图),改成0(透明,意味着该元素显示的是背景颜色,默认的灰色),再改成1,是为了获得过渡效果
  173. // this.opacity = 0;
  174. // // 这里设置为0,是为了图片展示到背景全透明这个过程时间为0,延时之后延时之后重新设置为duration,是为了获得背景透明(灰色)
  175. // // 到图片展示的过程中的淡入效果
  176. // this.durationTime = 0;
  177. // // 延时50ms,否则在浏览器H5,过渡效果无效
  178. // setTimeout(() => {
  179. // this.durationTime = this.duration;
  180. // this.opacity = 1;
  181. // setTimeout(() => {
  182. // this.removeBgColor();
  183. // }, this.durationTime);
  184. // }, 50);
  185. },
  186. // 移除图片的背景色
  187. removeBgColor() {
  188. // 淡入动画过渡完成后,将背景设置为透明色,否则png图片会看到灰色的背景
  189. this.backgroundStyle = {
  190. backgroundColor: 'transparent'
  191. };
  192. }
  193. }
  194. };
  195. </script>
  196. <style lang="scss" scoped>
  197. @import '../../libs/css/components.scss';
  198. $u-image-error-top:0px !default;
  199. $u-image-error-left:0px !default;
  200. $u-image-error-width:100% !default;
  201. $u-image-error-hight:100% !default;
  202. $u-image-error-background-color:$u-bg-color !default;
  203. $u-image-error-color:$u-tips-color !default;
  204. $u-image-error-font-size: 46rpx !default;
  205. .u-image {
  206. position: relative;
  207. transition: opacity 0.5s ease-in-out;
  208. &__image {
  209. width: 100%;
  210. height: 100%;
  211. }
  212. &__loading,
  213. &__error {
  214. position: absolute;
  215. top: $u-image-error-top;
  216. left: $u-image-error-left;
  217. width: $u-image-error-width;
  218. height: $u-image-error-hight;
  219. @include flex;
  220. align-items: center;
  221. justify-content: center;
  222. background-color: $u-image-error-background-color;
  223. color: $u-image-error-color;
  224. font-size: $u-image-error-font-size;
  225. }
  226. }
  227. </style>