萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

jQuery 圖片預載入與延遲載入完整實作指南

一、自製通用預載入工具函式


/**
 * @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);

二、Lazy Load Plugin(經典延遲載入)

依賴 jQuery,適用於長頁面大量圖片。

HTML 準備




初始化


$("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 的圖片。

三、現代原生替代方案(無依賴)

IntersectionObserver API


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 專案、需相容舊瀏覽器 → jquery.lazyload。
  • 新專案、追求效能與標準 → 原生 IntersectionObserver + loading="lazy"(HTML 標準屬性,瀏覽器原生支援)。
copyright © 萬盛學電腦網 all rights reserved