萬盛學電腦網

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

JavaScript 圖片預載入與載入完成偵測完整教學

核心原理

建立 Image 物件並設定 src 即會觸發瀏覽器下載。若圖片已在快取中,complete 屬性為 true,可立即觸發回調;否則監聽 onload 事件。

通用預載入工具函數

/**
 * 預載入圖片並回調
 * @param {string} url - 圖片 URL
 * @param {function} callback - 回調函數,this 指向 Image 物件
 */
function loadImage(url, callback) {
    const img = new Image();
    img.src = url;

    if (img.complete) {
        // 快取命中,同步觸發
        callback.call(img);
        return;
    }

    img.onload = function() {
        callback.call(img);
        // 防止重複觸發(某些瀏覽器可能多次觸發)
        img.onload = null;
    };

    // 建議補上錯誤處理
    img.onerror = function() {
        console.error("圖片載入失敗:" + url);
    };
}

使用範例

// 單張預載入
loadImage("banner.jpg", function() {
    console.log(`圖片載入完成:${this.width} x ${this.height}`);
    document.body.appendChild(this); // 直接插入已載入的 img 元素
});

// 批量預載入(Promise 版)
function preloadImages(urls) {
    return Promise.all(urls.map(url => new Promise((resolve, reject) => {
        const img = new Image();
        img.src = url;
        img.onload = () => resolve(img);
        img.onerror = () => reject(new Error(`Failed: ${url}`));
    })));
}

preloadImages(["a.jpg", "b.jpg", "c.jpg"])
    .then(imgs => {
        console.log("所有圖片就緒");
        imgs.forEach(img => document.querySelector("#gallery").appendChild(img));
    })
    .catch(err => console.error(err));

傳統 onload 寫法(舊專案維護參考)

<img id="img2" src="images/1.jpg" />
<script>
    document.getElementById("img2").onload = function() {
        alert("圖片加載已完成");
    };
</script>

進階技巧

  • 響應式圖片預載: 結合 srcset/sizes 或 <picture>,根據裝置像素比預載適當解析度。
  • 中斷預載: 設定 img.src = "" 可取消進行中的下載(節省頻寬)。
  • WebP/AVIF 回退: 先嘗試載入新格式,onerror 時回退至 JPEG/PNG。
copyright © 萬盛學電腦網 all rights reserved