做圖片排版或相簿動畫時,往往需要等一組圖片全部就位才開始計算尺寸。本文提供一個以 jQuery 撰寫的輔助函數,達成「全部載入完成才觸發回調」的效果。
function when_images_loaded($img_container, callback) {
/* 當 $img_container 內的圖片全部載入後執行 callback。
前提:容器內的圖片皆為新插入者,且本函數在插入後立即呼叫。 */
var _imgs = $img_container.find('img'),
img_length = _imgs.length,
img_load_cntr = 0;
if (img_length) {
_imgs.on('load', function() {
img_load_cntr++;
if (img_load_cntr == img_length) {
callback();
}
});
} else {
// 容器內沒有圖片,直接執行回調
callback();
}
}
每張圖觸發 load 就把 img_load_cntr 加一,一旦計數等於總數就呼叫回調。這比「設一個固定時間的 setTimeout 猜它應該載完了吧」可靠得多。
其一,若圖片在綁定監聽之前就已載入完成(例如命中快取),load 不會再觸發,計數永遠湊不滿。因應之道是綁定後再逐一檢查 img.complete。
其二,這個版本只聽 load,不處理載入失敗的情況;一張圖 404 就會讓回調永遠不執行。正式環境建議同時監聽 error 並一併計入。