本文详细讲解如何在 Vue 3 组合式 API 中精准监听单张图片的加载完成状态,借助响应式 ref 与 @load 事件,为每张卡片独立控制骨架屏(Skeleton)的显示逻辑,有效避免因初始值误判导致的骨架屏闪退问题。
在 Vue 项目中,骨架屏是一项非常实用的用户体验优化手段——当用户等待数据加载时,可以提前看到一个“界面轮廓”,而不必面对空白页面干着急。然而,许多团队在实际开发中踩过一个常见的坑:骨架屏一闪而过,刚刚渲染出来就立即消失,而图片实际上还没有加载完毕。这种体验甚至比没有骨架屏还要糟糕。
问题的根源在哪里?其实就出在 ref() 的初始化行为上。如果直接调用 ref() 而不传入参数,返回的值是 undefined,而 undefined === false 的运算结果为 false。这意味着,当你使用 v-if="isLoaded === false" 来控制骨架屏的显示时,该条件从一开始就永远不会成立——骨架屏在页面加载之初就无法正常渲染。这才是闪退现象的本质原因。
解决方案非常直接:让每个卡片自行管理自己的加载状态,而不是由父组件统一控制。
✅ 正确做法:为每个卡片独立管理加载状态
核心思路是:将 isLoaded 的控制权下放到每个 ItemCard 组件内部,父组件仅负责数据获取以及骨架屏的占位展示。这样一来,每张图片的加载进度彼此独立,互不干扰。
1. 父组件:移除全局 isLoaded,改用插槽 + 条件渲染
注意,父组件不再在模板中插入一个全局的 isLoaded 变量。数据尚未返回时,直接循环渲染三个 ItemCardSkeleton 作为占位。数据到达后,再渲染真实的卡片——但每张卡片内部的图片加载状态,由子组件自行掌控。
2. 子组件:每个卡片独立跟踪自身图片加载状态
![]()
{{ data.title }}
{{ data.text }}
View more
这里最关键的一行是:const isLoaded = ref(false);。将初始值设为 false,而不是不传参。这样骨架屏从一开始就能正常显示。当图片加载完成后,@load 事件将 isLoaded 更新为 true,骨架屏随之消失,图片与内容一同呈现。
此外,务必处理 @error 事件。如果图片链接失效而不做处理,骨架屏将永远停留在页面上。将 isLoaded 也设为 true,即使图片加载失败,用户至少能够看到文字内容,而不是一个空荡荡的灰色占位块。
⚠️ 注意事项与最佳实践
- 勿共享 ref 实例:每个
ItemCard必须拥有自己独立的isLoaded = ref(false),否则所有卡片将共享同一个状态,失去“逐张加载、逐张显示”的预期效果。 - 处理加载失败:添加
@error监听并将isLoaded设为true,防止图片 404 导致骨架屏永久停留。 - CSS 骨架动画建议:使用
@keyframes pulse实现渐变灰度动画,比静态色块更符合现代 UX 设计规范。 - 性能优化:如果卡片数量较多,可结合
IntersectionObserver实现图片懒加载,进一步减轻首屏渲染压力。
通过以上重构,骨架屏将严格遵循“数据 pending → 显示全局 skeleton;单图未加载 → 显示该卡片 skeleton;单图加载完成 → 立即替换为真实内容”的行为逻辑,彻底解决闪退问题,实现流畅、可控的加载体验。
