圖片連結失效、路徑打錯、CDN 暫時掛掉——這些狀況在真實專案裡無可避免。與其讓瀏覽器顯示那個破碎的圖示,不如攔下錯誤事件,換上一張預設的替代圖,讓版面至少保持完整。
$("img").error(function () {
$(this).attr("src", "missing_image.gif");
});
當任一張圖片載入失敗,就把它的 src 換成 missing_image.gif。概念就這麼簡單:監聽 error 事件,在該事件發生時改寫來源。
1. 無限迴圈。如果替代圖本身也不存在,改寫 src 會再次觸發 error,於是又改寫一次,形成迴圈。解法是在第一次處理後就把事件解除,或設一個旗標:
$("img").on("error", function () {
var $img = $(this);
if ($img.data("fallback")) return; // 已經換過,不再處理
$img.data("fallback", 1);
$img.attr("src", "missing_image.gif");
});
2. 已經出錯的圖片不會補救。如果腳本執行時某張圖早就載入失敗了,事件不會再補發一次。可以在綁定後主動檢查 img.complete 與 img.naturalWidth:
$("img").each(function () {
if (this.complete && this.naturalWidth === 0) {
$(this).attr("src", "missing_image.gif");
}
});
error() 已不建議使用,請改用 on("error", ...);若要處理日後動態加入的圖片,可用委派寫法 $(document).on("error", "img", handler)。src,就完全不必擔心替代圖也會 404,也不必多發一次請求。alt 仍然說明了這張圖該是什麼,對螢幕閱讀器很重要,不要一併清掉。$(this).hide(),或加上一個灰色底的 class 呈現佔位。這是一個典型的「防禦性寫法」:正常情況下使用者完全不會察覺它的存在,但一旦有連結失效,它就替你把體驗接住。