DIV CSS 佈局教程網

圖片 404 怎麼辦?用 onerror 隱藏或替換成預設圖的完整方案
編輯:關於JavaScript     

網站經營久了,難免會出現圖片 404——可能是檔案本來就不存在,或暫時無法取得。常見處理方式有兩種:把壞圖隱藏起來,或替換成預設佔位圖。兩者都比讓瀏覽器顯示破圖示好得多。

img 標籤有哪些事件可用

img 支援的事件很多,包括 onabort、onblur、onchange、onclick、ondblclick、onerror、onfocus、onkeydown、onload、onmousedown、onmousemove、onmouseover、onmouseout、onmouseup、onresize、onload、onscroll、onselect、onsubmit、onunload 等。其中三個最實用:

  • onerror:圖片載入過程中發生錯誤時觸發,這就是處理 404 的入口。
  • onabort:載入中途被使用者中止時觸發,常用來提示「圖片正在載入」。
  • onload:圖片載入完成後觸發。

1. 直接監聽 onerror

 <img src="someimage.png" onerror="imgError(this);" />

 // 原生 JS
 function imgError(image){
  image.style.display = 'none';                                  // 隱藏圖片
  // image.setAttribute("src", "images/demo.png");                // 或替換為預設圖
 }

 // 使用 jQuery
 function imgError(image){
  $(image).hide();
  // $(image).attr("src", "images/demo.png");
 }

注意:處理函式要定義在 img 之前(例如放在 head 裡),否則圖片先出錯時函式還沒被讀到,反而會觸發無限迴圈。

如果要用「替換成預設圖」的做法,務必加防護,避免預設圖本身也 404 時陷入死循環:

 function imgError(image){
 if (!image.dataset.fallback) {
  image.dataset.fallback = '1';
  image.src = 'images/demo.png';
 } else {
  image.style.display = 'none';
 }
}

2. 用 jQuery 集中監聽 error

 // 通常不會把 JS 內嵌在 HTML 裡,可用 .error 統一處理
 $('#test img').error(function() {
  $(this).hide();
  // $(this).attr("src", "images/demo.png");
 });

注意:jQuery 必須在 img 之前載入,處理函式則要寫在 img 之後。另外,.error() 在 jQuery 3 已移除,請改用 .on('error', handler)。更關鍵的細節是:如果圖片在綁定事件之前就已經出錯,事件不會補發。可靠做法是在綁定後主動檢查一次 img.complete 與 img.naturalWidth。

3. 封裝成通用函式

 // 原生 JS 通用方案
 function $id(id) {
  return !id || id.nodeType === 1 ? id : document.getElementById(id);
 }

 function isType(o, t) {
  return (typeof o).indexOf(t.charAt(0).toLowerCase()) === 0;
 }

 function image(src, cfg) {
  var img, prop, target;

  cfg = cfg || (isType(src, 'o') ? src : {});
  img = $id(src);

  if (img) {
   src = cfg.src || img.src;
  } else {
   img = document.createElement('img');
   src = src || cfg.src;
  }

  if (!src) { return null; }

  // 依瀏覽器能力決定用 width 還是 naturalWidth
  prop = isType(img.naturalWidth, 'u') ? 'width' : 'naturalWidth';

  img.alt = cfg.alt || img.alt;
  img.src = src;

  target = $id(cfg.target);
  if (target) {
   target.insertBefore(img, $id(cfg.insertBefore) || null);
  }

  if (img.complete) {
   // 已載入(可能來自快取)
   if (img[prop]) {
    if (isType(cfg.success, 'f')) { cfg.success.call(img); }
   } else {
    if (isType(cfg.failure, 'f')) { cfg.failure.call(img); }
   }
  } else {
   if (isType(cfg.success, 'f')) { img.onload = cfg.success; }
   if (isType(cfg.failure, 'f')) { img.onerror = cfg.failure; }
  }

  return img;
 }

這個函式能做什麼

用途一:取得圖片資訊(是否可下載、實際寬高)

 image('img', {
 success : function () {
  alert(this.width + "-" + this.height);
 },
 failure : function () {
  alert('image 404!');
 }
});

 // 驗證資源是否可取得
 image('images/banner/banner_2.jpg', {
 success : function () { console.log('success'); },
 failure : function () { console.log('failure'); },
 target : 'myContainerId',
 insertBefore : 'someChildOfmyContainerId'
});

用途二:下載並插入圖片,同時回報結果

 var report = $id('report');

 var callback = {
 success : function () {
  report.innerHTML += '<p>Success - ' + this.src
   + ' (' + this.offsetWidth + 'x' + this.offsetHeight + ')</p>';
 },
 failure : function () {
  report.innerHTML += '<p>Failure - ' + this.src
   + ' (' + this.offsetWidth + 'x' + this.offsetHeight + ')</p>';
 },
 target : 'target'
 };

 image('img', callback);
 image('images/banner/banner_2.jpg', callback);

補充觀念

naturalWidth 與 width 的差別值得記住:前者是圖片原始尺寸(不受 CSS 影響),後者是目前渲染後的尺寸。判斷圖片是否真的載入成功,最可靠的依據是 naturalWidth > 0,而不是 complete——complete 在圖片失敗時也會是 true。

另一個實務做法是集中處理:與其為每張圖寫 onerror,不如用事件捕獲在 document 上攔一次:

 document.addEventListener('error', function (e) {
  var el = e.target;
  if (el.tagName === 'IMG' && !el.dataset.fallback) {
   el.dataset.fallback = '1';
   el.src = 'images/demo.png';
  }
}, true);   // 第三個參數為 true,因為 error 不冒泡,必須用捕獲階段

最後提醒:替代文字(alt)不要省。當圖片真的載不出來時,alt 是唯一能讓使用者知道那裡原本該有什麼的線索,也是螢幕閱讀器的依據。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved