vue自定义指令，比onerror更优雅的方式实现当图片加载失败时使用默认图，提供三种方法

最新推荐文章于 2024-08-19 10:26:50 发布

qq_夏阳

最新推荐文章于 2024-08-19 10:26:50 发布

阅读量431

点赞数

分类专栏： vue

vue 专栏收录该内容

15 篇文章

订阅专栏

本文介绍了三种处理图片加载失败的方法：使用onerror事件、通过Vue绑定onerror和自定义Vue指令。详细解释了每种方法的工作原理，包括如何避免图片加载死循环，并提供了代码示例。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

一、常规方法解决

我们都知道，img标签支持onerror事件，在装载文档或图像的过程中如果发生了错误，就会触发onerror事件。可以使用一张提示错误的图片代替显示不了的图片。

例如这样使用：

<img src="images/logo.png" "javascript:this.src='images/logoError.png';">

当图片不存在时，将触发 onerror，而onerror 中又为img 指定一个logoError.png 图片。也就是说图片存在则显示logo.png，图片不存在将显示 logoError.png。
但是，注意哦，这里有个大坑哦，如果logoError.png 也不存在，则会继续触发 onerror，导致死循环，页面卡死。而且，就算图片存在，但网络很不通畅，也可能触发 onerror。
当然，解决办法是有的：

<img src="images/logo.png" "notfound();"/>

<script type="text/javascript">
    function notfound() {
        var img = event.srcElement;
        img.src = "images/logoError.png";
        img.onerror = null; //解绑onerror事件
    }
</script>

二、通过vue绑定onerror实现

本质上跟第一种方法是差不多的

使用方法：

<img :src="images/logo.png" :"defaultImg">

<script>
    export default {
        name: "imgError",
        data() {
            return {
                defaultImg: 'this.src="' + require('images/logoError.png') + '"' //默认图地址
            }
        }
    }
</script>

同样的，这里也会遇到跟第一种方法类似的问题，当默认图也不存在时，图片加载死循环。

三、通过vue自定义指令
注意哦，大招来了O！！！每次使用vue的指令都感觉好爽，特别的方便，现在自己搞一个，用起来会更爽。

在这之前，先了解下vue的自定义指令到底怎么玩，还是很有必要的。
这种东西呢，还是看文档吧，文档写得挺详细的。传送门：https://cn.vuejs.org/v2/guide/custom-directive.html

首先在入口文件定义一个全局指令

//全局注册自定义指令，用于判断当前图片是否能够加载成功，可以加载成功则赋值为img的src属性，否则使用默认图片
Vue.directive('real-img', async function (el, binding) {//指令名称为：real-img
    let imgURL = binding.value;//获取图片地址
    if (imgURL) {
        let exist = await imageIsExist(imgURL);
        if (exist) {
            el.setAttribute('src', imgURL);
        } 
    }
})

/**
 * 检测图片是否存在
 * @param url
 */
let imageIsExist = function(url) {
    return new Promise((resolve) => {
        var img = new Image();
        img.onload = function () {
            if (this.complete == true){
                resolve(true);
                img = null;
            }
        }
        img.onerror = function () {
            resolve(false);
            img = null;
        }
        img.src = url;
    })
}

然后使用的时候就特别方便了，因为是全局注册的，所以每个页面都可以直接使用

<!--v-real-img 就是刚刚定义的指令，绑定的为真实要显示的图片地址。src为默认图片地址-->
<img src="images/logoError.png" v-real-img="images/logo.png">

使用这种方法还有一个天然的优势，那就是当网速较慢或者图片一次性加载较多的话，可以达到占位图的效果。来，look look。

Okay，三种方法都介绍完了，选哪种各凭喜好！

看完之后有什么不懂的，可以留言反馈。

DEMO GitHub地址：https://github.com/TangSY/vue-img-onerror

转载请注明出处：https://www.jianshu.com/p/394c487d81d7
作者：TSY
个人空间：https://www.hxkj.vip