vue 解决img图片路径存在但图片无法访问时显示错误的问题

文章目录

项目场景

在前端开发中,img 标签常用于展示用户头像,核心需求是优先加载用户自定义头像,无自定义头像时展示默认头像。

问题描述

常规开发中,我们会通过逻辑判断处理头像路径为空的情况,代码如下:

typescript 复制代码
<img :src="item.attachUrl || defaultUser" alt="用户头像"/>

上述代码仅能判断 attachUrl 是否为空,若 attachUrl 有值但对应的图片资源实际访问失败(如图片文件丢失、路径错误、网络问题等),页面中头像位置会显示图片加载失败的破损样式,影响用户体验。

原因分析

  1. item.attachUrl || defaultUser 仅做值是否为空的逻辑判断,无法检测图片资源的实际可访问性;
  2. 图片加载失败属于网络/资源层面的错误,需通过 img 标签的原生事件捕获这类异常。

解决方案

利用 img 标签的 error 事件监听图片加载失败的情况,触发事件时将图片地址替换为默认头像,具体实现如下:

1. 模板代码(Vue)

html 复制代码
<!-- 绑定src并监听error事件 -->
<img 
  :src="item.attachUrl" 
  alt="用户头像" 
  @error="handleImgError" 
/>

2. 逻辑处理(TypeScript)

typescript 复制代码
// 引入默认头像资源
import defaultUser from "./img/user-icon.png";

/**
 * 处理图片加载失败的逻辑
 * @param e - 图片error事件对象
 */
const handleImgError = (e: Event) => {
  const target = e.target as HTMLImageElement;
  // 替换为默认头像
  target.src = defaultUser;
  // 可选:重置图片样式,避免加载失败的占位样式
  target.style.display = "inline-block";
  // 可选:防止error事件循环触发(若默认头像也加载失败)
  target.onerror = null;
};

优化补充

为避免默认头像也加载失败导致 error 事件循环触发,在事件处理函数中添加 target.onerror = null,确保仅替换一次。

总结

  1. 单纯的空值判断无法覆盖图片路径有效但资源不可访问的场景,需结合 img 的 error 事件处理;
  2. 图片加载失败时,通过事件对象替换 src 为默认头像,并可重置样式、阻断事件循环,保证用户体验;
  3. 核心逻辑:空值兜底 + 加载异常捕获,双重保障头像展示的稳定性。
相关推荐
一个游离的指针1 小时前
Vue2:vue-router
前端·javascript·vue.js
千寻技术帮2 小时前
10454_基于Springboot的企业购销链管理系统
spring boot·mysql·vue·毕业设计·进销存
火山引擎和TA的超级拍档们3 小时前
产品情报局 11 | AI 数据湖 LAS:打造大模型时代多模态数据底座
前端·后端
JavaGuide3 小时前
Gemini 真的变强了,写代码做视频的能力接近 Claude Opus5.5 了!
前端·ai编程
niceyayale4 小时前
WebRTC 延迟怎么调试:从 ICE 到 jitter buffer 的六个观测点
前端
aleimu4 小时前
Windows 11 右键打开 Cmder 2.0:从找不到菜单到默认使用 Cmder
前端·人工智能·后端
tryCbest4 小时前
Vue系列——第 20 篇:Vue Router 4——路由管理完全指南(上)
前端·javascript·vue.js
feixing_fx4 小时前
原始类型与引用类型:赋值时到底复制了什么
开发语言·前端·javascript·前端框架
一条破秋裤4 小时前
【1115】【多线程】【笔记】
前端·chrome·笔记
黑十4 小时前
FDE 怎么快速搭一个可演示页面?最小前端方案
java·大数据·前端·数据库·人工智能