/**
* @param {Array|jQuery} arr - 圖片 URL 陣列 或 img jQuery 物件集合
* @param {Function} funLoading - 單張載入完成回調 (loadedCount, total, src, dom)
* @param {Function} funOnLoad - 全部載入完成回調 (errorCount)
* @param {Function} funOnError - 單張載入失敗回調 (loadedCount, total, src, dom)
*/
function loadimg(arr, funLoading, funOnLoad, funOnError) {
var loaded = 0, errors = 0;
var isJQ = arr instanceof $;
var list = isJQ ? arr.get() : arr;
for (var i = 0; i < list.length; i++) {
var src = isJQ ? $(list[i]).data('src') : list[i];
preload(src, list[i]);
}
function preload(src, dom) {
var img = new Image();
img.onload = function() {
loaded++;
funLoading && funLoading(loaded, list.length, src, dom);
if (loaded === list.length) funOnLoad && funOnLoad(errors);
};
img.onerror = function() {
loaded++; errors++;
funOnError && funOnError(loaded, list.length, src, dom);
};
img.src = src;
}
}
// 回調:全部完成
var onAllLoaded = function(errors) {
console.log("載入完成,錯誤 " + errors + " 張");
};
// 回調:單張完成(URL 陣列版)
var onEachLoad = function(n, total, src) {
console.log(n + "/" + total + " loaded: " + src);
var img = new Image(); img.src = src;
$(img).hide().appendTo('body').fadeIn();
};
// 回調:單張完成(jQuery 物件版,直接替換 src)
var onEachLoadObj = function(n, total, src, dom) {
$(dom).attr('src', src).fadeIn(200);
};
// 回調:錯誤處理
var onErr = function(n, total, src) {
console.warn("第 " + n + " 張載入失敗: " + src);
};
// 調用:傳入 URL 陣列
loadimg([
"https://example.com/1.jpg",
"https://example.com/2.jpg"
], onEachLoad, onAllLoaded, onErr);
// 或調用:傳入已存在的 img 元素(data-src 存真實路徑)
// loadimg($('img.lazy'), onEachLoadObj, onAllLoaded, onErr);
依賴 jQuery,適用於長頁面大量圖片。
$("img.lazy").show().lazyload({
threshold: 200, // 提前 200px 載入
effect: "fadeIn", // 載入動畫
event: "scroll" // 觸發事件(可改 click、mouseover)
});
data-original:真實圖片 URL。placeholder:載入前佔位圖(預設 1x1 灰圖)。failure_limit:頁面內圖片超出視窗數量仍繼續檢查的門檻(預設 0,適合長頁)。skip_invisible:忽略 display:none 的圖片。
const observer = new IntersectionObserver((entries, obs) => {
entries.forEach(entry => {
if (entry.isIntersecting) {
const img = entry.target;
img.src = img.dataset.src;
img.onload = () => img.classList.add('loaded');
obs.unobserve(img);
}
});
}, { rootMargin: '200px' }); // 提前 200px
document.querySelectorAll('img.lazy').forEach(img => observer.observe(img));
CSS 配合:
img.lazy { opacity: 0; transition: opacity 0.3s; }
img.lazy.loaded { opacity: 1; }
loadimg 或原生 IntersectionObserver。jquery.lazyload。