jQuery图片加载失败替换默认图片方法汇总

本文主要讨论页面中图片加载失败后替换默认图片的几种方式

重点来了：一定要记住error事件不冒泡。

相关的知识点：jquery的ready方法、$("img").error()、img的complete属性、插件imagesLoaded、事件委托、事件捕获和图片预加载的方法等

1. 图片加载失败替换为默认图片

1.1 给图片绑定error事件

当图片加载失败时会触发error事件

$("img").on("error", function () {
  $(this).attr("src", "../img/img.jpg");
});

• 不建议事件事件属性onerror，你懂的~O.o
• 如果是动态添加的图片，还要重新绑定这个事件。像click事件这些可以利用事件委托的方式，但是事件委托是利用事件冒泡的思路来做的，而error事件不支持冒泡
• 不建议在ready方法中给img绑定error事件，可能img加载图片失败时，img并没有绑定error事件，就会导致没有替换为默认图片

1.2 利用complete属性来判断

当图片加载失败时complete属性值为false，加载成功时true

$("img").each(function () {

  if (!this.complete || (typeof this.naturalWidth == "undefined" && this.naturalWidth == 0) || !this.src) {
    $(this).attr("src", "../img/img.jpg");
  }
});

• 如果是动态添加的图片，还是要重新判断的
• 可以在一点时间后再来判断，不然刚新增图片，图片资源可能还没有请求完就用这个方式来判断会有问题的
• HTML 5中，新增了两个用来判断图片的宽度和高度的属性，分别为 naturalWidth 和naturalHeight属性（必须在图片完全下载到客户端浏览器才能判断）
• img的onreadystatechange这个属性不讨论，有浏览器差异性

1.3 利用error事件捕获来处理（全局判断，动态添加的元素也可以-最优解）

document.addEventListener("error", function (e) {

  var elem = e.target;
  if (elem.tagName.toLowerCase() == 'img') {
    elem.src = "../img/img.jpg";
  }
}, true);

可以监听到动态产生的img标签

1.4 利用插件imagesLoaded提供的方法来处理

imagesLoaded主要用来在手机端瀑布流方式来加载图片，也可以用来处理图片加载失败替换为默认图片

// 用的是jQuery的deferred来实现的
$('img').imagesLoaded()
    .always(function (instance) { // always事件，在所有图片都加载完成（成功与否不论）时触发
      console.log('all images loaded');
    })
    .done(function (instance) { // done事件，在所有图片都加载成功时触发
      console.log('all images successfully loaded');
    })
    .fail(function (instance) { // fail事件，在所有图片都加载完成，并且至少有一张图片加载失败时触发
      console.log('all images loaded, at least one is broken');
    })
    .progress(function (instance, image) { // progress事件，在每一张图片加载完成时都触发一次
      var result = image.isLoaded ? 'loaded' : 'broken'; // 判断当前图片加载成功与否
      image.img.src = image.isLoaded ? image.img.src : "../img/img.jpg";
      console.log('image is ' + result + ' for ' + image.img.src);
    });

如果是动态添加的图片，还是要重新判断的

2. 图片预加载的方法

// 实现预加载图片，传入的参数是数组，数组的每一项为该图片的地址
function preloadimages(arr) {
  var newimages = [];
  var arr = (typeof arr != "object") ? [arr] : arr; // 确保参数总是数组
  for (var i = 0,len = arr.length; i < len; i++) {
    newimages[i] = new Image();
    newimages[i].src = arr[i];
  }
}

总结