網站經營久了,難免會出現圖片 404——可能是檔案本來就不存在,或暫時無法取得。常見處理方式有兩種:把壞圖隱藏起來,或替換成預設佔位圖。兩者都比讓瀏覽器顯示破圖示好得多。
img 支援的事件很多,包括 onabort、onblur、onchange、onclick、ondblclick、onerror、onfocus、onkeydown、onload、onmousedown、onmousemove、onmouseover、onmouseout、onmouseup、onresize、onload、onscroll、onselect、onsubmit、onunload 等。其中三個最實用:
<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';
}
}
// 通常不會把 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。
// 原生 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 是唯一能讓使用者知道那裡原本該有什麼的線索,也是螢幕閱讀器的依據。