236 lines
8.1 KiB
Vue
236 lines
8.1 KiB
Vue
<template>
|
||
<u-transition
|
||
mode="fade"
|
||
:show="show"
|
||
:duration="fade ? 1000 : 0"
|
||
>
|
||
<view
|
||
class="u-image"
|
||
@tap="onClick"
|
||
:style="[wrapStyle, backgroundStyle]"
|
||
>
|
||
<image
|
||
v-if="!isError"
|
||
:src="src"
|
||
:mode="mode"
|
||
@error="onErrorHandler"
|
||
@load="onLoadHandler"
|
||
:show-menu-by-longpress="showMenuByLongpress"
|
||
:lazy-load="lazyLoad"
|
||
class="u-image__image"
|
||
:style="{
|
||
borderRadius: shape == 'circle' ? '10000px' : $u.addUnit(radius),
|
||
width: $u.addUnit(width),
|
||
height: $u.addUnit(height)
|
||
}"
|
||
></image>
|
||
<view
|
||
v-if="showLoading && loading"
|
||
class="u-image__loading"
|
||
:style="{
|
||
borderRadius: shape == 'circle' ? '50%' : $u.addUnit(radius),
|
||
backgroundColor: this.bgColor,
|
||
width: $u.addUnit(width),
|
||
height: $u.addUnit(height)
|
||
}"
|
||
>
|
||
<slot name="loading">
|
||
<u-icon
|
||
:name="loadingIcon"
|
||
:width="width"
|
||
:height="height"
|
||
></u-icon>
|
||
</slot>
|
||
</view>
|
||
<view
|
||
v-if="showError && isError && !loading"
|
||
class="u-image__error"
|
||
:style="{
|
||
borderRadius: shape == 'circle' ? '50%' : $u.addUnit(radius),
|
||
width: $u.addUnit(width),
|
||
height: $u.addUnit(height)
|
||
}"
|
||
>
|
||
<slot name="error">
|
||
<u-icon
|
||
:name="errorIcon"
|
||
:width="width"
|
||
:height="height"
|
||
></u-icon>
|
||
</slot>
|
||
</view>
|
||
</view>
|
||
</u-transition>
|
||
</template>
|
||
|
||
<script>
|
||
import props from './props.js';
|
||
import mpMixin from '../../libs/mixin/mpMixin.js';
|
||
import mixin from '../../libs/mixin/mixin.js';
|
||
/**
|
||
* Image 图片
|
||
* @description 此组件为uni-app的image组件的加强版，在继承了原有功能外，还支持淡入动画、加载中、加载失败提示、圆角值和形状等。
|
||
* @tutorial https://uiadmin.net/uview-plus/components/image.html
|
||
* @property {String} src 图片地址
|
||
* @property {String} mode 裁剪模式，见官网说明 （默认 'aspectFill' ）
|
||
* @property {String | Number} width 宽度，单位任意，如果为数值，则为px单位 （默认 '300' ）
|
||
* @property {String | Number} height 高度，单位任意，如果为数值，则为px单位 （默认 '225' ）
|
||
* @property {String} shape 图片形状，circle-圆形，square-方形 （默认 'square' ）
|
||
* @property {String | Number} radius 圆角值，单位任意，如果为数值，则为px单位 （默认 0 ）
|
||
* @property {Boolean} lazyLoad 是否懒加载，仅微信小程序、App、百度小程序、字节跳动小程序有效 （默认 true ）
|
||
* @property {Boolean} showMenuByLongpress 是否开启长按图片显示识别小程序码菜单，仅微信小程序有效 （默认 true ）
|
||
* @property {String} loadingIcon 加载中的图标，或者小图片 （默认 'photo' ）
|
||
* @property {String} errorIcon 加载失败的图标，或者小图片 （默认 'error-circle' ）
|
||
* @property {Boolean} showLoading 是否显示加载中的图标或者自定义的slot （默认 true ）
|
||
* @property {Boolean} showError 是否显示加载错误的图标或者自定义的slot （默认 true ）
|
||
* @property {Boolean} fade 是否需要淡入效果 （默认 true ）
|
||
* @property {Boolean} webp 只支持网络资源，只对微信小程序有效 （默认 false ）
|
||
* @property {String | Number} duration 搭配fade参数的过渡时间，单位ms （默认 500 ）
|
||
* @property {String} bgColor 背景颜色，用于深色页面加载图片时，为了和背景色融合 (默认 '#f3f4f6' )
|
||
* @property {Object} customStyle 定义需要用到的外部样式
|
||
* @event {Function} click 点击图片时触发
|
||
* @event {Function} error 图片加载失败时触发
|
||
* @event {Function} load 图片加载成功时触发
|
||
* @example <u-image width="100%" height="300px" :src="src"></u-image>
|
||
*/
|
||
export default {
|
||
name: 'u-image',
|
||
mixins: [mpMixin, mixin, props],
|
||
data() {
|
||
return {
|
||
// 图片是否加载错误，如果是，则显示错误占位图
|
||
isError: false,
|
||
// 初始化组件时，默认为加载中状态
|
||
loading: true,
|
||
// 不透明度，为了实现淡入淡出的效果
|
||
opacity: 1,
|
||
// 过渡时间，因为props的值无法修改，故需要一个中间值
|
||
durationTime: this.duration,
|
||
// 图片加载完成时，去掉背景颜色，因为如果是png图片，就会显示灰色的背景
|
||
backgroundStyle: {},
|
||
// 用于fade模式的控制组件显示与否
|
||
show: false
|
||
};
|
||
},
|
||
watch: {
|
||
src: {
|
||
immediate: true,
|
||
handler(n) {
|
||
if (!n) {
|
||
// 如果传入null或者''，或者false，或者undefined，标记为错误状态
|
||
this.isError = true
|
||
|
||
} else {
|
||
this.isError = false;
|
||
this.loading = true;
|
||
}
|
||
}
|
||
}
|
||
},
|
||
computed: {
|
||
wrapStyle() {
|
||
let style = {};
|
||
// 通过调用addUnit()方法，如果有单位，如百分比，px单位等，直接返回，如果是纯粹的数值，则加上rpx单位
|
||
style.width = this.$u.addUnit(this.width);
|
||
style.height = this.$u.addUnit(this.height);
|
||
// 如果是显示圆形，设置一个很多的半径值即可
|
||
style.borderRadius = this.shape == 'circle' ? '10000px' : uni.$u.addUnit(this.radius)
|
||
// 如果设置圆角，必须要有hidden，否则可能圆角无效
|
||
style.overflow = this.radius > 0 ? 'hidden' : 'visible'
|
||
// if (this.fade) {
|
||
// style.opacity = this.opacity
|
||
// // nvue下，这几个属性必须要分开写
|
||
// style.transitionDuration = `${this.durationTime}ms`
|
||
// style.transitionTimingFunction = 'ease-in-out'
|
||
// style.transitionProperty = 'opacity'
|
||
// }
|
||
return uni.$u.deepMerge(style, uni.$u.addStyle(this.customStyle));
|
||
|
||
}
|
||
},
|
||
mounted() {
|
||
this.show = true
|
||
},
|
||
emits: ['click', 'error', 'load'],
|
||
methods: {
|
||
// 点击图片
|
||
onClick() {
|
||
this.$emit('click')
|
||
},
|
||
// 图片加载失败
|
||
onErrorHandler(err) {
|
||
this.loading = false
|
||
this.isError = true
|
||
this.$emit('error', err)
|
||
},
|
||
// 图片加载完成，标记loading结束
|
||
onLoadHandler(event) {
|
||
this.loading = false
|
||
this.isError = false
|
||
this.$emit('load', event)
|
||
this.removeBgColor()
|
||
// 如果不需要动画效果，就不执行下方代码，同时移除加载时的背景颜色
|
||
// 否则无需fade效果时，png图片依然能看到下方的背景色
|
||
// if (!this.fade) return this.removeBgColor();
|
||
// // 原来opacity为1(不透明，是为了显示占位图)，改成0(透明，意味着该元素显示的是背景颜色，默认的灰色)，再改成1，是为了获得过渡效果
|
||
// this.opacity = 0;
|
||
// // 这里设置为0，是为了图片展示到背景全透明这个过程时间为0，延时之后延时之后重新设置为duration，是为了获得背景透明(灰色)
|
||
// // 到图片展示的过程中的淡入效果
|
||
// this.durationTime = 0;
|
||
// // 延时50ms，否则在浏览器H5，过渡效果无效
|
||
// setTimeout(() => {
|
||
// this.durationTime = this.duration;
|
||
// this.opacity = 1;
|
||
// setTimeout(() => {
|
||
// this.removeBgColor();
|
||
// }, this.durationTime);
|
||
// }, 50);
|
||
},
|
||
// 移除图片的背景色
|
||
removeBgColor() {
|
||
// 淡入动画过渡完成后，将背景设置为透明色，否则png图片会看到灰色的背景
|
||
this.backgroundStyle = {
|
||
backgroundColor: 'transparent'
|
||
};
|
||
}
|
||
}
|
||
};
|
||
</script>
|
||
|
||
<style lang="scss" scoped>
|
||
@import '../../libs/css/components.scss';
|
||
|
||
$u-image-error-top:0px !default;
|
||
$u-image-error-left:0px !default;
|
||
$u-image-error-width:100% !default;
|
||
$u-image-error-hight:100% !default;
|
||
$u-image-error-background-color:$u-bg-color !default;
|
||
$u-image-error-color:$u-tips-color !default;
|
||
$u-image-error-font-size: 46rpx !default;
|
||
|
||
.u-image {
|
||
position: relative;
|
||
transition: opacity 0.5s ease-in-out;
|
||
|
||
&__image {
|
||
width: 100%;
|
||
height: 100%;
|
||
}
|
||
|
||
&__loading,
|
||
&__error {
|
||
position: absolute;
|
||
top: $u-image-error-top;
|
||
left: $u-image-error-left;
|
||
width: $u-image-error-width;
|
||
height: $u-image-error-hight;
|
||
@include flex;
|
||
align-items: center;
|
||
justify-content: center;
|
||
background-color: $u-image-error-background-color;
|
||
color: $u-image-error-color;
|
||
font-size: $u-image-error-font-size;
|
||
}
|
||
}
|
||
</style>
|