feat: 新增 SafeImage 安全图片组件
添加带错误处理和默认占位的图片组件,防止图片加载失败导致页面异常
This commit is contained in:
119
flash-sale-frontend/src/components/common/SafeImage.vue
Normal file
119
flash-sale-frontend/src/components/common/SafeImage.vue
Normal file
@@ -0,0 +1,119 @@
|
|||||||
|
<template>
|
||||||
|
<div :class="['safe-image', wrapperClass, { 'is-clickable': clickable }]" @click="handleClick">
|
||||||
|
<div v-if="!loaded" class="safe-image__placeholder">
|
||||||
|
<div class="safe-image__shimmer"></div>
|
||||||
|
</div>
|
||||||
|
<img
|
||||||
|
:src="currentSrc"
|
||||||
|
:alt="alt"
|
||||||
|
:class="['safe-image__img', imgClass, { 'is-loaded': loaded }]"
|
||||||
|
:loading="lazy ? 'lazy' : 'eager'"
|
||||||
|
@load="handleLoad"
|
||||||
|
@error="handleError"
|
||||||
|
>
|
||||||
|
</div>
|
||||||
|
</template>
|
||||||
|
|
||||||
|
<script setup lang="ts">
|
||||||
|
import { ref, watch } from 'vue'
|
||||||
|
import { DEFAULT_PRODUCT_IMAGE, resolveImageUrl } from '@/utils/image'
|
||||||
|
|
||||||
|
interface Props {
|
||||||
|
src?: string | null
|
||||||
|
alt?: string
|
||||||
|
imgClass?: string
|
||||||
|
wrapperClass?: string
|
||||||
|
lazy?: boolean
|
||||||
|
clickable?: boolean
|
||||||
|
}
|
||||||
|
|
||||||
|
const props = withDefaults(defineProps<Props>(), {
|
||||||
|
alt: '',
|
||||||
|
imgClass: '',
|
||||||
|
wrapperClass: '',
|
||||||
|
lazy: true,
|
||||||
|
clickable: false,
|
||||||
|
})
|
||||||
|
|
||||||
|
const emit = defineEmits<{
|
||||||
|
click: []
|
||||||
|
}>()
|
||||||
|
|
||||||
|
const currentSrc = ref(DEFAULT_PRODUCT_IMAGE)
|
||||||
|
const loaded = ref(false)
|
||||||
|
const fallbackApplied = ref(false)
|
||||||
|
|
||||||
|
const resetSource = () => {
|
||||||
|
currentSrc.value = resolveImageUrl(props.src)
|
||||||
|
loaded.value = false
|
||||||
|
fallbackApplied.value = false
|
||||||
|
}
|
||||||
|
|
||||||
|
watch(() => props.src, resetSource, { immediate: true })
|
||||||
|
|
||||||
|
const handleLoad = () => {
|
||||||
|
loaded.value = true
|
||||||
|
}
|
||||||
|
|
||||||
|
const handleError = () => {
|
||||||
|
if (fallbackApplied.value) {
|
||||||
|
loaded.value = true
|
||||||
|
return
|
||||||
|
}
|
||||||
|
|
||||||
|
fallbackApplied.value = true
|
||||||
|
currentSrc.value = DEFAULT_PRODUCT_IMAGE
|
||||||
|
}
|
||||||
|
|
||||||
|
const handleClick = () => {
|
||||||
|
if (props.clickable) {
|
||||||
|
emit('click')
|
||||||
|
}
|
||||||
|
}
|
||||||
|
</script>
|
||||||
|
|
||||||
|
<style scoped lang="scss">
|
||||||
|
.safe-image {
|
||||||
|
position: relative;
|
||||||
|
overflow: hidden;
|
||||||
|
background: #f8fafc;
|
||||||
|
|
||||||
|
&.is-clickable {
|
||||||
|
cursor: pointer;
|
||||||
|
}
|
||||||
|
|
||||||
|
&__placeholder {
|
||||||
|
position: absolute;
|
||||||
|
inset: 0;
|
||||||
|
background: linear-gradient(180deg, #f8fafc 0%, #eef2f7 100%);
|
||||||
|
}
|
||||||
|
|
||||||
|
&__shimmer {
|
||||||
|
width: 100%;
|
||||||
|
height: 100%;
|
||||||
|
background: linear-gradient(90deg, rgba(255,255,255,0) 0%, rgba(255,255,255,0.55) 50%, rgba(255,255,255,0) 100%);
|
||||||
|
animation: shimmer 1.4s infinite;
|
||||||
|
}
|
||||||
|
|
||||||
|
&__img {
|
||||||
|
width: 100%;
|
||||||
|
height: 100%;
|
||||||
|
opacity: 0;
|
||||||
|
transition: opacity 0.2s ease;
|
||||||
|
display: block;
|
||||||
|
|
||||||
|
&.is-loaded {
|
||||||
|
opacity: 1;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
@keyframes shimmer {
|
||||||
|
0% {
|
||||||
|
transform: translateX(-100%);
|
||||||
|
}
|
||||||
|
100% {
|
||||||
|
transform: translateX(100%);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
</style>
|
||||||
Reference in New Issue
Block a user