圖片上傳前預覽是現代表單的標準體驗。本文提供基於 FileReader API 的完整跨瀏覽器實作,支援單張/多張預覽、拖曳上傳、圖片驗證、記憶體管理、以及舊版瀏覽器降級方案。
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)}
`;
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 存入隱藏欄位送往後端
}
});
<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 不支援 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);
}
});
readAsDataURL):Base64 字串佔用記憶體約原檔 1.33 倍,大量大圖易造成 OOM。適用於小圖預覽 (頭像、縮圖)URL.createObjectURL()):建立指向記憶體 Blob 的短網址,**必須呼叫 URL.revokeObjectURL() 釋放**,否則記憶體洩漏。適用於大圖、需取得原始尺寸現代圖片預覽核心為 FileReader.readAsDataURL() 搭配 <input type="file" accept="image/*">。生產環境需包含:類型/大小驗證、多檔管理、拖曳支援、移除功能、記憶體釋放、錯誤處理。封裝為可複用 Class (如上方 ImagePreviewer) 可大幅提升開發效率與程式碼品質。