在 Web 開發中,讓使用者上傳圖片前即時預覽是常見需求。HTML5 提供了兩種核心 API 來達成此功能:URL.createObjectURL() 與 FileReader。本文將詳細解析兩者的運作原理、程式碼實作與優缺點比較,助你快速整合圖片預覽功能。
| 方法 | 運作機制 | 優點 | 缺點 |
|---|---|---|---|
| URL.createObjectURL() | 建立指向 File 或 Blob 物件的暫時 URL,瀏覽器可直接當作圖片來源載入。 |
速度極快、不需讀取檔案內容、記憶體佔用低。 | URL 僅在文件存活期間有效,需手動呼叫 revokeObjectURL() 釋放記憶體。 |
| FileReader.readAsDataURL() | 將檔案讀取為 Base64 編碼的 Data URL,直接嵌入 src 屬性。 |
相容性極佳、可直接儲存或傳輸字串。 | 大檔案轉換較慢、Base64 體積約增加 33%、佔用較多記憶體。 |
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>HTML5 圖片上傳預覽</title>
<style>
#preview { width: 300px; height: 300px; overflow: hidden; border: 1px solid #ddd; }
#preview img { width: 100%; height: 100%; object-fit: cover; }
</style>
</head>
<body>
<input type="file" accept="image/*" id="fileInput">
<div id="preview"></div>
<script src="https://code.jquery.com/jquery-3.6.0.min.js"></script>
<script>
// 方法一:URL.createObjectURL
function previewWithURL(file) {
const url = URL.createObjectURL(file);
const $img = $('<img>').attr('src', url);
$img.on('load', function() {
URL.revokeObjectURL(url); // 釋放記憶體
$('#preview').empty().append($img);
});
}
// 方法二:FileReader
function previewWithFileReader(file) {
const reader = new FileReader();
reader.onload = function(e) {
const $img = $('<img>').attr('src', e.target.result);
$('#preview').empty().append($img);
};
reader.readAsDataURL(file);
}
// 綁定事件
$(function() {
$('#fileInput').on('change', function(e) {
const file = e.target.files[0];
if (!file || !file.type.startsWith('image/')) return;
// 這裡示範使用 URL 方法,實際專案可依需求切換
previewWithURL(file);
});
});
</script>
</body>
</html>
URL.createObjectURL() 時,務必在圖片載入完成後呼叫 URL.revokeObjectURL(),避免記憶體洩漏。file.type 確認為圖片格式,並可限制檔案大小。e.target.files 陣列,動態建立多個預覽區塊。一般情況下,優先使用 URL.createObjectURL(),因其效能優異、不阻塞主執行緒。僅當需要將圖片轉為 Base64 字串儲存(如離線快取、直接送入 Canvas 處理)時,才改用 FileReader。結合兩者優點,可打造流暢、穩定的圖片上傳體驗。