DIV CSS 佈局教程網

圖片 onload 事件觸發異常的解決辦法
編輯:關於JavaScript     

某個專案裡遇到這樣的狀況:圖片的 onload 回呼時好時壞,而且會隨著頁面尺寸不同、甚至程式碼所在位置不同而改變行為。同一份程式碼,換個地方貼就失靈。Firefox 下則一切正常。

問題的本質:快取圖片不會觸發 onload

原因其實不複雜:如果圖片已經在瀏覽器快取裡,那麼設定 src 之後圖片可能「瞬間完成載入」,甚至在你掛上 onload 之前就已經 load 完了。此時 onload 自然永遠不會被呼叫。

這也解釋了為什麼行為會「隨機」:

  • 第一次開啟頁面 → 無快取 → onload 正常觸發。
  • 重新整理 → 有快取 → onload 可能不觸發。
  • 圖片尺寸大、載入慢 → 掛 handler 的時間足夠 → 觸發。
  • 圖片是小圖示、載入極快 → handler 還沒掛好就結束了 → 不觸發。

解法:讓 src 在 onload 掛好之後才變動

思路是:先給一個臨時的佔位圖片,等頁面載入過程中再用 JS 換成真正的 src。只要每次 onload 觸發前 src 都發生變化,且 handler 已經掛上,onload 的表現就會正常。

<img id="pic" src="blank.gif" />
<script>
var img = document.getElementById('pic');
img.onload = function () {
  console.log('loaded', this.naturalWidth);
};
img.src = 'real.jpg';    // handler 掛好之後才換 src
</script>

關鍵順序:先掛 handler,再設 src。這個順序本身就足以解決大多數情況,佔位圖只是額外的保險。

更穩健的寫法:檢查 complete

即使順序正確,仍無法完全排除「同步快取」的邊界情況。標準做法是掛完 handler 之後主動檢查一次:

function bindImageLoad(img, callback) {
  img.onload = function () {
    img.onload = null;
    callback(img);
  };
  if (img.complete) {          // 已經載入完成(通常來自快取)
    img.onload = null;
    callback(img);
  }
}

img.complete 為 true 代表圖片已經載入完畢(成功或失敗都算),此時直接呼叫回呼即可。要注意它只表示「處理完了」,不保證成功,若需確認是否成功要再檢查 naturalWidth > 0。

為什麼 Firefox 沒這個問題

各家瀏覽器對「快取圖片是否觸發 load 事件」的實作時機不同。Firefox 早期會把事件排進佇列延後觸發,因此即使 handler 掛得晚一些也來得及;IE 與 WebKit 系則可能在 src 設定的當下就同步完成。這屬於規格留白處的實作差異,不是 bug。

現代寫法

今天的標準做法有兩個:

// 1. 使用 decode(),它會等待解碼完成
img.src = 'real.jpg';
img.decode().then(function () { /* 可以安全繪製了 */ });

// 2. 使用 loading="lazy" 讓瀏覽器自行決定時機
<img src="real.jpg" loading="lazy" decoding="async" />

decode() 特別有用,因為 onload 觸發時圖片未必已完成解碼,直接畫到 canvas 上在部分瀏覽器會出錯。decode() 回傳的 Promise 確保解碼完成,這比依賴 onload 更嚴謹。

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