112 lines
2.8 KiB
Vue
112 lines
2.8 KiB
Vue
<script setup lang="ts">
|
|
import { NImage } from 'naive-ui'
|
|
import { ref, watch } from 'vue'
|
|
|
|
/** 全局图片加载组件参数。 */
|
|
interface Props {
|
|
/** 图片地址。 */
|
|
src: string
|
|
/** 图片替代文本。 */
|
|
alt: string
|
|
/** 图片在容器内的适应方式。 */
|
|
objectFit?: 'contain' | 'cover'
|
|
/** 是否允许查看原图。 */
|
|
preview?: boolean
|
|
/** 是否启用浏览器原生懒加载。 */
|
|
lazy?: boolean
|
|
}
|
|
|
|
/** 全局图片加载组件事件。 */
|
|
interface Emits {
|
|
/** 图片加载失败事件。 */
|
|
error: [event: Event]
|
|
}
|
|
|
|
/** 图片展示参数。 */
|
|
const props = withDefaults(defineProps<Props>(), { objectFit: 'cover', preview: false, lazy: true })
|
|
|
|
/** 图片加载事件。 */
|
|
const emit = defineEmits<Emits>()
|
|
|
|
/** 图片是否已经加载完成。 */
|
|
const loaded = ref(false)
|
|
|
|
/** 图片地址变化后恢复加载占位状态。 */
|
|
function reset() {
|
|
loaded.value = false
|
|
}
|
|
|
|
/** 图片加载完成后直接切换为淡入状态。 */
|
|
function reveal() {
|
|
loaded.value = true
|
|
}
|
|
|
|
/**
|
|
* 转发图片加载失败事件。
|
|
* @param event 图片加载失败事件
|
|
*/
|
|
function fail(event: Event) {
|
|
emit('error', event)
|
|
}
|
|
|
|
/** 监听图片地址变化并重置加载状态。 */
|
|
watch(() => props.src, reset)
|
|
</script>
|
|
|
|
<template>
|
|
<span class="reveal-image" :class="{ 'is-loaded': loaded }" :aria-busy="!loaded">
|
|
<NImage
|
|
:src="src"
|
|
:preview-src="src"
|
|
:alt="alt"
|
|
:lazy="lazy"
|
|
:preview-disabled="!preview"
|
|
:object-fit="objectFit"
|
|
:img-props="{ referrerpolicy: 'no-referrer' }"
|
|
:previewed-img-props="{ alt, referrerpolicy: 'no-referrer' }"
|
|
@load="reveal"
|
|
@error="fail"
|
|
/>
|
|
<!-- 以下是 Instagram 风格的图片加载骨架模块 -->
|
|
<span v-if="!loaded" class="reveal-image-placeholder" aria-hidden="true" />
|
|
</span>
|
|
</template>
|
|
|
|
<style>
|
|
@reference "../../styles/styles.css";
|
|
.reveal-image {
|
|
@apply relative block w-full h-full min-w-0 min-h-0 overflow-hidden bg-(--app-subtle);
|
|
}
|
|
.reveal-image > .n-image,
|
|
.reveal-image > .n-image img {
|
|
@apply w-full h-full min-w-0 min-h-0;
|
|
}
|
|
.reveal-image > .n-image img {
|
|
opacity: 0;
|
|
transition: opacity 220ms cubic-bezier(0.25, 1, 0.5, 1);
|
|
}
|
|
.reveal-image.is-loaded > .n-image img {
|
|
opacity: 1;
|
|
}
|
|
.reveal-image-placeholder {
|
|
@apply absolute inset-0 pointer-events-none;
|
|
background-color: var(--app-control);
|
|
animation: reveal-image-pulse 1.2s cubic-bezier(0.65, 0, 0.35, 1) infinite alternate;
|
|
}
|
|
@keyframes reveal-image-pulse {
|
|
from {
|
|
opacity: 0.72;
|
|
}
|
|
to {
|
|
opacity: 1;
|
|
}
|
|
}
|
|
@media (prefers-reduced-motion: reduce) {
|
|
.reveal-image > .n-image img,
|
|
.reveal-image-placeholder {
|
|
animation: none;
|
|
transition: none;
|
|
}
|
|
}
|
|
</style>
|