讲师中心 微信公众号
AI工具推荐 视频效率加速

如何在 React 中优雅处理图片加载失败并显示默认占位图

云浩小哥_6856

云浩小哥_6856

发布时间:2026-01-11 11:19:36

|

514人浏览过

|

来源于php中文网

原创

如何在 React 中优雅处理图片加载失败并显示默认占位图

本文介绍了在 react 应用中通过 `onerror` 事件监听图片加载失败(如 404),并动态替换为默认图片的正确实现方式,避免无限循环和语法错误。

在 React 中,当 <img> 标签的 src 指向一个无法访问的资源(例如服务器返回 404)时,浏览器会触发 onError 事件。但需注意:直接在 JSX 中写 onError={this.src="..."} 是无效且错误的——这既不是合法的事件处理器(语法错误),也无法访问 DOM 元素;而仅靠三元判断 !imgURL 只能处理空值或假值,无法捕获已渲染但加载失败的图片。

✅ 正确做法是使用函数式事件处理器,在 onError 回调中获取当前 <img> 元素,并安全地更新其 src:

React Component Auditor
React Component Auditor

审计 React 组件的性能、可访问性、Hook 正确性、属性设计和重渲染优化——识别 memo 优化点和状态管理方案

下载
<img
  src={!imgURL ? "https://image.defaultimg.jpg" : imgURL}
  onError={({ currentTarget }) => {
    currentTarget.onerror = null; // 关键:清除事件监听器,防止递归触发
    currentTarget.src = "https://image.defaultimg.jpg";
  }}
  className="card-img-top"
  alt="Product image"
/>

? 关键细节说明:

  • currentTarget 指向当前绑定事件的 <img> 元素,确保操作准确;
  • currentTarget.onerror = null 是必需步骤:否则当默认图也加载失败时,会再次触发 onError,导致无限循环甚至页面卡顿;
  • 优先保留 src 的条件判断(!imgURL ? ... : ...),可同时覆盖「空 URL」和「加载失败」两种场景;
  • 建议为默认图 URL 使用稳定、高可用的 CDN 地址,并确保格式/尺寸与业务图一致,以维持 UI 一致性。

? 进阶提示:若项目中多处使用该逻辑,可封装为自定义 Hook(如 useImageFallback)或可复用组件(如 <SafeImage />),进一步提升可维护性与健壮性。

热门AI工具

更多
DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

PixTV
PixTV Hot

PixTV是一款面向AIGC内容创作的AI视频生成工具。

超级简历WonderCV

一款AI办公效率工具,主要用于免费求职简历模版下载制作,应届生职场人必备简历制作神器,适合需要提升相关任务效率的用户。

PixPix
PixPix Hot

PixPix是一款面向电商视觉生产的AI商品图生成工具。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

切问学术

切问学术是一款AI论文写作工具,复旦大学NLP团队推出的AI学术智能体。

AionClaw
AionClaw Hot

AionClaw是一款面向办公、创作和编程任务的AI桌面智能体。

立刻MV
立刻MV Hot

立刻MV是一款AI文本写作工具,AI 音乐视频(MV)创作工具。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

相关专题

更多
c语言中null和NULL的区别
c语言中null和NULL的区别

c语言中null和NULL的区别是:null是C语言中的一个宏定义,通常用来表示一个空指针,可以用于初始化指针变量,或者在条件语句中判断指针是否为空;NULL是C语言中的一个预定义常量,通常用来表示一个空值,用于表示一个空的指针、空的指针数组或者空的结构体指针。

549

2023.09.22

java中null的用法
java中null的用法

在Java中,null表示一个引用类型的变量不指向任何对象。可以将null赋值给任何引用类型的变量,包括类、接口、数组、字符串等。想了解更多null的相关内容,可以阅读本专题下面的文章。

1678

2024.03.01

DOM是什么意思
DOM是什么意思

dom的英文全称是documentobjectmodel,表示文件对象模型,是w3c组织推荐的处理可扩展置标语言的标准编程接口;dom是html文档的内存中对象表示,它提供了使用javascript与网页交互的方式。想了解更多的相关内容,可以阅读本专题下面的文章。

6501

2024.08.14

Linux 新手先学哪些命令
Linux 新手先学哪些命令

Linux新手命令专题汇集终端基础、文件目录操作、文本查看、软件安装和权限管理等入门文章,帮助按实际任务练习常用命令并建立命令行操作习惯。

0

2026.10.15

MySQL 忘记密码怎么办
MySQL 忘记密码怎么办

MySQL忘记密码专题汇集不同版本与系统下的root密码重置方法,覆盖MySQL 5.7、8.0、Mac、Linux及本地集成环境,并提示恢复权限与重新登录的检查步骤。

0

2026.10.15

Vue.js 中 ref 和 reactive 的区别
Vue.js 中 ref 和 reactive 的区别

Vue.js中ref和reactive的区别专题汇集两种响应式API的定义、访问方式、对象解构、侦听与性能取舍等文章,帮助结合实际状态类型选择合适写法。

0

2026.10.15

VS Code 怎么配置开发环境
VS Code 怎么配置开发环境

VS Code开发环境专题汇集编辑器安装、语言扩展、编译器、解释器、终端和调试配置文章,覆盖Java、Python、C++和PHP等常见语言的入门设置。

0

2026.10.15

C++ 开发环境怎么搭建
C++ 开发环境怎么搭建

C++开发环境专题汇集Windows、Linux下的编译器与IDE安装配置教程,涵盖GCC、Clang、Visual Studio、CLion和VS Code,以及编译运行首个程序的步骤。

0

2026.10.15

Python 虚拟环境是什么
Python 虚拟环境是什么

Python虚拟环境专题介绍项目依赖隔离的作用,汇集venv与uv创建、激活、退出及解释器切换的相关文章,并覆盖Windows、Linux和VS Code中的常见配置问题。

0

2026.10.15

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
React 教程
React 教程

共58课时 | 12.2万人学习

国外Web开发全栈课程全集
国外Web开发全栈课程全集

共12课时 | 1.4万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn