「選擇圖片後立刻預覽,上傳前先確認」是很常見的需求。傳統做法要把檔案先送到伺服器再回傳網址,延遲高又浪費頻寬。HTML5 的 FileReader API 讓這件事完全在瀏覽器端完成。
<!doctype html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>js 圖片預覽</title>
</head>
<body>
<input type="file" id="file" accept="image/*">
<div style="width:300px;height:300px;border:1px solid #ccc">
<img id="img_show" src="" />
</div>
<script type="text/javascript" src="./jquery-3.1.1.min.js"></script>
<script type="text/javascript">
var Util = {
file: $("#file"),
image_show: $("#img_show")
};
Util.file.onchange = function(f) {
// 型別檢查
if (this.files[0].type.indexOf('image') < 0) {
alert("請選擇圖片檔案!");
return;
}
// 大小檢查
if (this.files[0].size / 1024 > 5 * 1024) {
alert("圖片過大,請選擇 5M 以下的檔案");
return;
}
// 瀏覽器支援檢查
if (typeof FileReader == 'undefined') {
alert("您的瀏覽器不支援 HTML5 FileReader,請更換瀏覽器後重試!");
return;
}
var reader = new FileReader();
reader.readAsDataURL(this.files[0]); // File 物件繼承自 Blob
reader.onload = function(e) {
// reader.result 是 base64 編碼後的 Data URL
Util.image_show.src = reader.result;
};
};
</script>
</body>
</html>
readAsDataURL() 是 FileReader 的四個讀取方法之一。它把檔案內容讀成一個 Data URL,格式類似 data:image/png;base64,iVBORw0KGgo...,可以直接指定給 img 的 src 顯示,不需要任何伺服器往返。
這裡有個型別細節值得記住:File 物件其實繼承自 Blob,所以任何 Blob 都能交給 FileReader 處理,不一定要來自 file input。
除了 readAsDataURL,FileReader 還提供三種方法,依用途選擇:
1. 用 URL.createObjectURL 取代 Data URL。大圖轉成 base64 會讓字串長度膨脹約三分之一,佔用記憶體也較多。改用 Object URL 效率更好,但要注意在使用完畢後呼叫 revokeObjectURL 釋放:
const url = URL.createObjectURL(file); img.src = url; // 使用完畢後 URL.revokeObjectURL(url);
2. 檢查圖片是否真的存在。input 的 accept="image/*" 只是提示,使用者仍可手動切換檔案類型。若需要嚴格把關,除了檢查 MIME type,還應在上傳後由伺服器端依實際檔案內容驗證。
3. 加入載入中狀態與錯誤處理。目前範例沒有設定 reader.onerror。大檔讀取需要時間,若無回饋,使用者會以為沒反應而重複點擊。
reader.onload = function(e) { img.src = e.target.result; };
reader.onerror = function() { alert('檔案讀取失敗,請重試'); };
4. 記得預覽圖的物件導向配置。img 標籤建議加上 alt 屬性,並在容器上設定 object-fit: contain,避免不同尺寸與比例的圖片撐壞版面。