萬盛學電腦網

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

jQuery 圖片預加載插件:併發控制、回調支援、錯誤處理

前言

頁面載入前預加載圖片可顯著提升用戶體驗(避免圖片逐個顯示、佈局跳動)。本文提供 jQuery 版預加載函式 preloadImages(list, callback),支援併發控制、載入完成回調、錯誤/中斷處理。

核心代碼

function preloadImages(oImageList, callback) {
    if (typeof oImageList !== 'object' || typeof callback !== 'function') return;

    var remaining = oImageList.length;
    var interval = setInterval(function () {
        if (remaining === 0) {
            clearInterval(interval);
            callback();
        }
    }, 100); // 每 100ms 檢查一次

    $.each(oImageList, function (i, src) {
        // 將陣列元素替換為 Image 物件
        oImageList[i] = new Image();

        oImageList[i].onload = function () {
            remaining--;
        };
        oImageList[i].onabort = function (e) {
            console.warn('圖片載入中斷:', src, e);
            remaining--;
        };
        oImageList[i].onerror = function (e) {
            console.error('圖片載入失敗:', src, e);
            remaining--;
        };

        // 若非完整 URL,可依專案需求拼接基礎路徑
        // if (!/^https?:\/\//.test(src)) src = basePath + src;
        oImageList[i].src = src;
    });
}

使用範例

var images = [
    '/img/banner1.jpg',
    '/img/banner2.jpg',
    '/img/icon-sprite.png'
];

preloadImages(images, function () {
    console.log('所有圖片預加載完成');
    // 可在此啟動輪播、顯示頁面等
    $('#slider').show().startSlider();
});

進階改良建議

  • 併發限制:瀏覽器對同域並發連接數有限制 (HTTP/1.1 通常 6 個)。大量圖片時可實作佇列,每次只啟動 N 個 new Image(),載入完成再啟動下一個。
  • Promise 版本:現代專案建議改用 Promise.all() 管理:
function preloadImagesPromise(list) {
    return Promise.all(list.map(function (src) {
        return new Promise(function (resolve, reject) {
            var img = new Image();
            img.onload = resolve;
            img.onerror = img.onabort = reject;
            img.src = src;
        });
    }));
}

// 使用
preloadImagesPromise(images).then(function () {
    console.log('完成');
}).catch(function (err) {
    console.error('有圖片失敗', err);
});

總結

預加載核心原理:建立 Image 物件並設定 src 觸發瀏覽器下載並緩存。本文提供 jQuery 回調版與現代 Promise 版兩種實作,可依專案環境選擇。

copyright © 萬盛學電腦網 all rights reserved