feat: 新增 SafeImage 安全图片组件

添加带错误处理和默认占位的图片组件,防止图片加载失败导致页面异常
This commit is contained in:
2026-03-10 23:23:40 +08:00
parent c52d9c52e3
commit b684ea38d4

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