DIV CSS 佈局教程網

等圖片全部加載完成後再執行回調
編輯:關於JavaScript     

做圖片牆、相冊或需要按圖片實際尺寸排版的效果時,必須等所有圖片真正加載完畢才能動手,否則拿到的高度全是 0。下面這個工具函數封裝了這件事。

實現代碼

function when_images_loaded($img_container, callback) {
  /*
   * 當 $img_container(jQuery 對象)內的圖片全部加載完成後執行 callback。
   * 使用前提:容器內是「剛插入的新圖片」,且本函數必須在插入後立即調用。
   */
  var _imgs = $img_container.find('img'),
      img_length = _imgs.length,
      img_load_cntr = 0;

  if (img_length) {
    // 容器內有新圖片:等它們全部 load 完再觸發
    _imgs.on('load', function () {
      img_load_cntr++;
      if (img_load_cntr == img_length) {
        callback();
      }
    });
  } else {
    // 沒有圖片,直接執行
    callback();
  }
}

它是怎麼工作的

先統計容器內的圖片總數,然後給每張圖綁定 load 事件,用一個計數器累加。當計數值等於總數時,說明全部到齊,於是本回調執行。若容器裡根本沒有圖片,則跳過等待直接執行,避免調用方永遠等不到結果。

使用時容易踩到的兩個坑

快取圖片可能不觸發 load。 如果圖片在綁定事件之前就已加載完成(例如命中瀏覽器快取),load 不會再次觸發,計數永遠湊不齊。穩妥的做法是在綁定後追加一次檢查:

_imgs.each(function () {
  if (this.complete) {          // 已經加載完成
    $(this).trigger('load');    // 手動補一次事件
  }
});

加載失敗也會導致卡住。 圖片 404 時只會觸發 error 而非 load。因此建議同時監聽 error,讓失敗的圖片也計入計數:

_imgs.on('load error', function () { /* 計數邏輯同上 */ });

如果不依賴 jQuery,原生寫法是把 find('img') 換成 container.querySelectorAll('img'),再用 forEach 遍歷綁定即可,思路完全一致。

另外補充一個現代方案:若目的是「等圖片解碼完成後再繪製到 canvas」,可以考慮 img.decode(),它返回 Promise,比 load 事件更貼近實際就緒時機。

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