上傳頭像時若能先看到預覽,使用者才敢按確定。這個功能不需要後端配合,用 File API 讀取本地檔案再塞進 img 的 src 就能做到。以下把整個能力封裝成一個可獨立剝離的方法,呼叫時傳入 file 元素、img 元素與一個回呼即可。
index.html 的內容非常精簡,一個 img 一個 file input,加上一段呼叫:
<html>
<head>
<title>Test</title>
<script type="text/javascript" src="js/z.js"></script>
</head>
<body>
<center>
<img id="img" src="" /><p />
<input type="file" id="file" />
</center>
<script>
z.plimg(z.$('file'), z.$('img'), function(file, img, url){
alert(url);
});
</script>
</body>
</html>
其中 z.js 是作者自己累積的工具庫,z.$ 是 getElementById 的簡寫,z.plimg 就是負責預覽的方法。
關鍵是 URL.createObjectURL(file),它會產生一個形如 blob:null/xxxx 的暫時位址,直接餵給 img.src 即可顯示。要注意這個位址必須在不再需要時手動釋放,否則會佔住記憶體:
var z = {
$: function(id){ return document.getElementById(id); },
/**
* 本地圖片預覽
* @param {HTMLInputElement} fileInput file 元素
* @param {HTMLImageElement} img 用於顯示預覽的 img 元素
* @param {Function} callback 回呼,參數為 (file, img, url)
*/
plimg: function(fileInput, img, callback){
if (!fileInput || !img) return;
fileInput.onchange = function(){
var file = this.files && this.files[0];
if (!file) return;
// 只接受圖片
if (!/^image\//.test(file.type)) {
alert('請選擇圖片檔');
return;
}
var url = URL.createObjectURL(file);
img.src = url;
img.onload = function(){
URL.revokeObjectURL(url); // 顯示完成後釋放,避免記憶體洩漏
};
callback && callback(file, img, url);
};
}
};
1. createObjectURL 是目前的標準做法,IE10 以下的舊版瀏覽器不支援,當時常見的替代方案是 FileReader.readAsDataURL() 讀成 base64。若要向下相容,可兩者並用:
var reader = new FileReader();
reader.onload = function(e){ img.src = e.target.result; };
reader.readAsDataURL(file);
2. base64 與 blob URL 的差別。base64 會把圖形放大約三分之一且佔記憶體,但可直接當作表單值送出;blob URL 輕巧但只在當前頁面有效,重新整理即失效。純預覽用 blob 更好,若要把預覽結果直接入庫則用 base64。
3. 記得限制大小與格式。正式專案應在 onchange 一開始就擋掉非圖片與過大檔案,避免使用者選到幾十 MB 的照片把瀏覽器拖垮。
4. 拖放支援。替 input 加上 dragover / drop 事件監聽,體驗會好很多。