萬盛學電腦網

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

JavaScript 圖片上傳預覽跨瀏覽器完整實作 (含 Firefox 相容)

前言

圖片上傳前預覽是現代表單的標準體驗。本文提供基於 FileReader API 的完整跨瀏覽器實作,支援單張/多張預覽、拖曳上傳、圖片驗證、記憶體管理、以及舊版瀏覽器降級方案。

核心 API:FileReader


const input = document.getElementById('file-input');
const preview = document.getElementById('preview');

input.addEventListener('change', handleFileSelect);

function handleFileSelect(e) {
    const files = e.target.files;
    if (!files.length) return;

    // 單張預覽 (取第一張)
    const file = files[0];
    previewFile(file);
}

function previewFile(file) {
    // 1. 檔案類型驗證
    if (!file.type.startsWith('image/')) {
        alert('請選擇圖片檔案');
        return;
    }

    // 2. 檔案大小限制 (例: 5MB)
    if (file.size > 5 * 1024 * 1024) {
        alert('圖片大小不可超過 5MB');
        return;
    }

    // 3. 建立 FileReader
    const reader = new FileReader();
    
    reader.onload = function(e) {
        // e.target.result 為 Data URL (base64)
        preview.src = e.target.result;
        preview.style.display = 'block';
    };

    reader.onerror = function() {
        alert('圖片讀取失敗');
    };

    // 4. 以 Data URL 讀取 (非同步)
    reader.readAsDataURL(file);
}

完整生產級元件封裝


class ImagePreviewer {
    constructor(options = {}) {
        this.input = document.querySelector(options.inputSelector);
        this.previewContainer = document.querySelector(options.previewSelector);
        this.maxFiles = options.maxFiles || 1;
        this.maxSize = options.maxSize || 5 * 1024 * 1024; // 5MB
        this.acceptTypes = options.acceptTypes || ['image/jpeg', 'image/png', 'image/gif', 'image/webp'];
        this.onPreviewReady = options.onPreviewReady || (() => {});
        this.onError = options.onError || (msg => alert(msg));

        this.bindEvents();
    }

    bindEvents() {
        // 檔案選擇
        this.input.addEventListener('change', e => this.handleFiles(e.target.files));

        // 拖曳上傳支援
        const dropZone = this.previewContainer.closest('.drop-zone') || this.previewContainer;
        ['dragenter', 'dragover', 'dragleave', 'drop'].forEach(evt => {
            dropZone.addEventListener(evt, e => e.preventDefault(), { passive: false });
        });
        dropZone.addEventListener('drop', e => this.handleFiles(e.dataTransfer.files));
    }

    handleFiles(fileList) {
        const files = Array.from(fileList).filter(f => this.acceptTypes.includes(f.type));
        
        if (!files.length) {
            this.onError('請選擇有效圖片檔案 (JPG/PNG/GIF/WebP)');
            return;
        }

        // 檢查數量限制
        const existing = this.previewContainer.querySelectorAll('.preview-item').length;
        if (existing + files.length > this.maxFiles) {
            this.onError(`最多只能上傳 ${this.maxFiles} 張圖片`);
            return;
        }

        files.forEach(file => {
            if (file.size > this.maxSize) {
                this.onError(`「${file.name}」超過 ${this.maxSize/1024/1024}MB 限制`);
                return;
            }
            this.createPreview(file);
        });

        // 重置 input 允許重複選擇同一檔案
        this.input.value = '';
    }

    createPreview(file) {
        const reader = new FileReader();
        const previewId = `preview-${Date.now()}-${Math.random().toString(36).substr(2, 9)}`;

        reader.onload = (e) => {
            const item = document.createElement('div');
            item.className = 'preview-item';
            item.dataset.previewId = previewId;
            item.innerHTML = `
                ${this.escapeHtml(file.name)}
                
                ${this.escapeHtml(file.name)}
            `;
            
            item.querySelector('.preview-remove').addEventListener('click', () => {
                item.remove();
                this.onPreviewReady(this.getAllPreviews());
            });

            this.previewContainer.appendChild(item);
            this.onPreviewReady(this.getAllPreviews());
        };

        reader.onerror = () => this.onError(`「${file.name}」讀取失敗`);
        reader.readAsDataURL(file);
    }

    getAllPreviews() {
        return [...this.previewContainer.querySelectorAll('.preview-item img')].map(img => ({
            src: img.src,
            name: img.alt
        }));
    }

    escapeHtml(str) {
        return str.replace(/[&<>"']/g, c => ({
            '&': '&', '<': '<', '>': '>', '"': '"', "'": '''
        })[c]);
    }

    // 公開方法:清空所有預覽
    clear() {
        this.previewContainer.innerHTML = '';
    }
}

// 使用範例
const previewer = new ImagePreviewer({
    inputSelector: '#avatar-input',
    previewSelector: '#avatar-previews',
    maxFiles: 1,
    maxSize: 2 * 1024 * 1024,
    onPreviewReady: (previews) => {
        console.log('目前預覽圖片:', previews);
        // 可將 previews[0].src 存入隱藏欄位送往後端
    }
});

對應 HTML 與 CSS


<div class="upload-area">
    <input type="file" id="avatar-input" accept="image/*" hidden>
    <div id="avatar-previews" class="preview-grid"></div>
    <button type="button" class="btn-upload-trigger">選擇頭像</button>
</div>

<style>
.upload-area { position: relative; }
.preview-grid { display: grid; grid-template-columns: repeat(auto-fill, 100px); gap: 10px; margin-top: 10px; }
.preview-item { position: relative; border: 1px solid #ddd; border-radius: 4px; overflow: hidden; background: #fafafa; }
.preview-item img { width: 100%; height: 100px; object-fit: cover; display: block; }
.preview-remove { position: absolute; top: 2px; right: 2px; width: 20px; height: 20px; background: rgba(0,0,0,0.6); color: white; border: none; border-radius: 50%; cursor: pointer; font-size: 14px; line-height: 18px; }
.preview-name { display: block; padding: 4px; font-size: 11px; white-space: nowrap; overflow: hidden; text-overflow: ellipsis; }
.btn-upload-trigger { margin-top: 10px; padding: 8px 16px; background: #007bff; color: white; border: none; border-radius: 4px; cursor: pointer; }
</style>

<script>
document.querySelector('.btn-upload-trigger').addEventListener('click', () => {
    document.getElementById('avatar-input').click();
});
</script>

舊版瀏覽器降級方案 (IE9-)

IE9 不支援 FileReader,需使用 ActiveXObject 或 Flash 方案,但現代專案建議**直接要求使用者升級瀏覽器**。若必須支援:


function previewIE9(fileInput, imgElement) {
    // IE 專屬:使用滤鏡顯示本地圖片 (需降低安全性設定)
    fileInput.select();
    const path = document.selection.createRange().text;
    imgElement.style.filter = `progid:DXImageTransform.Microsoft.AlphaImageLoader(src='${path}', sizingMethod='scale')`;
    imgElement.src = 'data:image/gif;base64,R0lGODlhAQABAIAAAAAAAP///yH5BAEAAAAALAAAAAABAAEAAAIBRAA7'; // 1px 透明 GIF
}

進階:取得圖片原始尺寸 (不等待載入完成)


function getImageDimensions(file) {
    return new Promise((resolve, reject) => {
        const url = URL.createObjectURL(file);
        const img = new Image();
        img.onload = () => {
            URL.revokeObjectURL(url); // 釋放記憶體
            resolve({ width: img.naturalWidth, height: img.naturalHeight });
        };
        img.onerror = () => {
            URL.revokeObjectURL(url);
            reject(new Error('圖片載入失敗'));
        };
        img.src = url;
    });
}

// 使用
input.addEventListener('change', async (e) => {
    const file = e.target.files[0];
    try {
        const { width, height } = await getImageDimensions(file);
        if (width < 200 || height < 200) {
            alert('圖片解析度過低,至少 200x200px');
            return;
        }
        // 通過驗證,進行預覽...
    } catch (err) {
        console.error(err);
    }
});

記憶體管理關鍵點

  • Data URL (readAsDataURL):Base64 字串佔用記憶體約原檔 1.33 倍,大量大圖易造成 OOM。適用於小圖預覽 (頭像、縮圖)
  • Blob URL (URL.createObjectURL()):建立指向記憶體 Blob 的短網址,**必須呼叫 URL.revokeObjectURL() 釋放**,否則記憶體洩漏。適用於大圖、需取得原始尺寸
  • 清理時機:預覽移除、頁面卸載、單頁應用路由切換時

總結

現代圖片預覽核心為 FileReader.readAsDataURL() 搭配 <input type="file" accept="image/*">。生產環境需包含:類型/大小驗證、多檔管理、拖曳支援、移除功能、記憶體釋放、錯誤處理。封裝為可複用 Class (如上方 ImagePreviewer) 可大幅提升開發效率與程式碼品質。

copyright © 萬盛學電腦網 all rights reserved