做圖片牆、相冊或需要按圖片實際尺寸排版的效果時,必須等所有圖片真正加載完畢才能動手,否則拿到的高度全是 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 事件更貼近實際就緒時機。