萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> Android 開發

HTML5 圖片預覽技術全解析:createObjectURL vs FileReader 兩大核心方案實戰

HTML5 圖片預覽兩大核心 API

在現代 Web 應用中,使用者選擇圖片後即時預覽是基本體驗。HTML5 提供兩種主要技術路徑:**URL.createObjectURL()** 與 **FileReader.readAsDataURL()**。兩者各有優劣,適用場景不同。

方案一:URL.createObjectURL() — 高效能、低記憶體、Blob URL

核心原理

瀏覽器為 `File`/`Blob` 物件建立一個短暫的內部 URL (`blob:https://...`),直接指向記憶體中的二進位資料,**不讀取檔案內容到 JS 字串**,因此極快、記憶體佔用極低。

實作範例

function previewWithObjectURL(file) {
    const img = new Image();
    const url = URL.createObjectURL(file); // 建立 Blob URL
    img.src = url;
    
    img.onload = () => {
        URL.revokeObjectURL(url); // **必須**釋放,否則記憶體洩漏
        $('#preview').empty().append(img);
    };
    
    img.onerror = () => {
        URL.revokeObjectURL(url);
        alert('圖片載入失敗');
    };
}

// 綁定 input change 事件
$('input[type="file"]').on('change', function(e) {
    const file = e.target.files[0];
    if (file && file.type.startsWith('image/')) {
        previewWithObjectURL(file);
    }
});

優缺點分析

優點缺點
極速:同步建立 URL,非同步解碼 URL 生命週期綁定 document,頁面卸載自動釋放,但**單頁應用 (SPA) 長期運行必須手動 revokeObjectURL**
記憶體極低:不將圖片解碼為 Base64 字串 無法直接取得 Base64 字串 (若需上傳 Base64 需額外轉換)
支援大檔案 (GB 級) 不會卡死主執行緒 跨域 `` 在某些舊瀏覽器受限

方案二:FileReader.readAsDataURL() — 取得 Base64 Data URL,適合需上傳 Base64 或離線儲存場景

核心原理

非同步讀取整個檔案並編碼為 Base64 字串 (`data:image/png;base64,iVBORw0K...`),賦值給 `img.src`。字串內含完整圖片資料,可直接儲存至 `localStorage`、IndexedDB 或作為 JSON 載荷上傳。

實作範例

function previewWithFileReader(file) {
    const reader = new FileReader();
    
    reader.onload = (e) => {
        const img = $('').attr('src', e.target.result);
        $('#preview').empty().append(img);
        // e.target.result 即為 Base64 Data URL,可直接存入資料庫/發送 API
    };
    
    reader.onerror = () => alert('讀取失敗');
    reader.readAsDataURL(file); // 觸發非同步讀取
}

優缺點分析

優點缺點
直接獲得 Base64 字串,便於儲存/傳輸 記憶體佔用大:Base64 體積約原檔 133%,大圖易導致記憶體壓力甚至崩潰
離線可用:Data URL 獨立存在,不依賴 Blob URL 生命週期 讀取大檔案明顯卡頓,阻塞主執行緒 (雖然是非同步,但解碼過程佔用資源)
相容性極佳 (IE10+) 不適合單純預覽場景 (過度殺傷)

進階:多檔案預覽、拖拽上傳、圖片壓縮

多檔案預覽

$('#multi-file').on('change', function(e) {
    const files = Array.from(e.target.files).filter(f => f.type.startsWith('image/'));
    const $preview = $('#preview').empty();
    
    files.forEach(file => {
        const url = URL.createObjectURL(file);
        const $img = $('').attr('src', url).css({maxWidth: '150px', margin: '5px'});
        $img.on('load', () => URL.revokeObjectURL(url));
        $preview.append($img);
    });
});

拖拽上傳支援

const dropZone = document.getElementById('drop-zone');
['dragenter','dragover','dragleave','drop'].forEach(evt => 
    dropZone.addEventListener(evt, e => { e.preventDefault(); e.stopPropagation(); }, false)
);
dropZone.addEventListener('drop', e => {
    const files = Array.from(e.dataTransfer.files).filter(f => f.type.startsWith('image/'));
    // 同樣用 createObjectURL 預覽
}, false);

客戶端圖片壓縮 (Canvas) — 解決大檔上傳頻寬/儲存成本

function compressAndPreview(file, maxWidth = 1200, quality = 0.8) {
    return new Promise(resolve => {
        const url = URL.createObjectURL(file);
        const img = new Image();
        img.onload = () => {
            URL.revokeObjectURL(url);
            const canvas = document.createElement('canvas');
            let {width, height} = img;
            if (width > maxWidth) {
                height = height * maxWidth / width;
                width = maxWidth;
            }
            canvas.width = width;
            canvas.height = height;
            const ctx = canvas.getContext('2d');
            ctx.drawImage(img, 0, 0, width, height);
            canvas.toBlob(blob => {
                resolve({
                    blob,                    // 壓縮後 Blob,可直接 FormData 上傳
                    dataUrl: canvas.toDataURL('image/jpeg', quality), // Base64
                    width, height
                });
            }, 'image/jpeg', quality);
        };
        img.src = url;
    });
}

// 使用
$('input[type="file"]').on('change', async e => {
    const file = e.target.files[0];
    if (!file) return;
    const {blob, dataUrl, width, height} = await compressAndPreview(file);
    $('#preview').empty().append($('').attr('src', dataUrl));
    // 上傳 blob
    const formData = new FormData();
    formData.append('image', blob, 'compressed_' + file.name);
    // fetch('/api/upload', {method:'POST', body:formData}) ...
});

瀏覽器相容性與 Polyfill

  • URL.createObjectURL:IE10+、所有現代瀏覽器。IE9 以下無支援,需回退 FileReader 或 Flash/ActiveX。
  • FileReader:IE10+、所有現代瀏覽器。
  • 舊版 IE (6-9) 專案建議使用 jQuery File Upload (含 iframe/Flash 回退) 或 Plupload。

總結:如何選擇?

場景推薦方案理由
單純預覽、多圖預覽、大圖預覽URL.createObjectURL高效能、低記憶體、無 Base64 開銷
需立即上傳 Base64 (如後端只接受 Base64)FileReader.readAsDataURL直接獲得 Data URL
需客戶端壓縮後上傳 BlobcreateObjectURL + Canvas.toBlob不經 Base64,直接產生壓縮 Blob
需離線儲存預覽圖 (localStorage/IndexedDB)FileReader.readAsDataURLData URL 可直接序列化儲存

**最佳實踐:** 預覽用 `createObjectURL`,上傳前若需壓縮用 Canvas 轉 Blob,若後端強制 Base64 再用 `FileReader` 或 `canvas.toDataURL()`。永遠記得 `URL.revokeObjectURL()` 釋放資源。

copyright © 萬盛學電腦網 all rights reserved