萬盛學電腦網

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

JavaScript 取得圖片原始尺寸:naturalWidth/naturalHeight 與相容寫法

問題

img.width 回傳的是顯示尺寸(受 CSS/width 屬性影響),非原始檔案尺寸。

現代標準屬性(IE9+、所有現代瀏覽器)

var img = document.querySelector('img');
console.log(img.naturalWidth, img.naturalHeight); // 原始像素尺寸

若圖片尚未載入完成,屬性為 0,需監聽 load 事件。

相容 IE6-8:建立新 Image 物件

function getNaturalSize(img, callback) {
    if (img.naturalWidth !== undefined) { // 現代瀏覽器
        callback(img.naturalWidth, img.naturalHeight);
    } else { // IE6-8
        var clone = new Image();
        clone.onload = function() {
            callback(clone.width, clone.height);
        };
        clone.src = img.src;
    }
}

// 使用
getNaturalSize(document.querySelector('img'), function(w, h) {
    console.log('原始尺寸:', w, 'x', h);
});

統一封裝(Promise 版)

function getNaturalSizePromise(img) {
    return new Promise(function(resolve) {
        if (img.complete && img.naturalWidth) {
            resolve({ width: img.naturalWidth, height: img.naturalHeight });
        } else {
            img.onload = function() {
                resolve({ width: img.naturalWidth, height: img.naturalHeight });
            };
            // 處理快取情況:若已完整載入但 onload 不再觸發
            if (img.complete) img.onload();
        }
    });
}

// 使用
getNaturalSizePromise(img).then(function(size) {
    console.log(size.width, size.height);
});

注意事項

  • 新建 Image() 不需加入 DOM 即可觸發下載與解碼。
  • 跨域圖片需伺服器設定 Access-Control-Allow-Origin 且 img.crossOrigin = 'anonymous',否則 naturalWidth 可能為 0(污染畫布)。
  • SVG 圖片在部分瀏覽器 naturalWidth 為 0,需指定 width/height 屬性或 CSS 尺寸。

應用場景

  • 圖片編輯器:計算縮放比例、裁切區域。
  • 懶載入:判斷原始尺寸決定是否載入高解析度版本。
  • 畫布繪製:drawImage 需原始尺寸計算縮放。
copyright © 萬盛學電腦網 all rights reserved