圖片上傳是再普通不過的功能,而預覽是其中不可少的一環。早期我做法是監聽 input[type=file] 的 onchange,一旦路徑變了就把檔案上傳到伺服器,取得回傳路徑後再塞給 img 顯示。且先不談非同步上傳的複雜度,光是伺服器要定期清理這些臨時預覽圖,就已經是筆可觀的負擔。
後來在 MDN 上找到純前端的做法,整理記錄如下。
FileReader 是 HTML5 的新特性,用於讀取 Blob 與 File 型別的資料。
構造
var fr = new FileReader();
屬性
readyState(unsigned short,唯讀):instance 的當前狀態,EMPTY = 0(尚未載入)、LOADING = 1(正在載入)、DONE = 2(讀取完成)。
result(唯讀):讀取到的檔案內容。
error(DOMError,唯讀):讀取過程中發生的錯誤。
方法
abort():中止讀取並把 readyState 設為 DONE;若當下沒有進行中的讀取,呼叫會丟出 DOM_FILE_ABORT_ERR。
readAsArrayBuffer(Blob blob):result 被設為 ArrayBuffer。
readAsText(Blob blob [, encoding='utf-8']):result 被設為字串。
readAsBinaryString(Blob blob):result 被設為原始二進位字串。
readAsDataURL(Blob blob):result 被設為 Data URI Scheme 形式,這正是預覽圖片要用的那一個。
事件
onload(讀取成功)、onerror(拋出異常)、onloadstart(開始前)、onloadend(結束後,在 onload 或 onerror 之後觸發)、onabort(中止後)、onprogress(讀取過程週期性觸發)。
瀏覽器支援:FF3.6+、Chrome7+、IE10+。
這個濾鏡主要用於圖片透明處理(IE5.5~6 不支援透明 PNG),但也可以拿來做預覽。
CSS 中的用法:
#preview {
filter: progid:DXImageTransform.Microsoft.AlphaImageLoader(sizingMethod=scale, src="dummy.png");
}
JS 中的用法:
var preview = document.getElementById('preview');
preview.style.filter = preview.currentStyle.filter +
";progid:DXImageTransform.Microsoft.AlphaImageLoader(sizingMethod=scale,src='dummy.png')";
preview.filters.item("DXImageTransform.Microsoft.AlphaImageLoader").src = "dummy1.png";
屬性說明:enabled(是否啟用,true 為預設)、sizingMethod(crop 裁剪以適應容器、image 縮放容器以適應圖片、scale 縮放圖片以適應容器)、src(必填,指向圖片 URL;當 img 的 src 指向本機路徑時會被瀏覽器阻擋)。
思路是:能支援的瀏覽器用 readAsDataURL 取得 Data URI 塞進 img;IE5.5~9 則改用 AlphaImageLoader 濾鏡。
HTML 片段:
<style type="text/css">
#preview{ width: 100px; height: 100px; }
</style>
<!--[if lte IE 9]>
<style type="text/css">
#preview{ filter: progid:DXImageTransform.Microsoft.AlphaImageLoader(sizingMethod=scale); }
</style>
<![endif]-->
<input type="file" onchange="showPreview(this);"/>
<div id="preview"></div>
JS 片段:
var preview = function (el) {
var pv = document.getElementById("preview");
// IE5.5~9 走濾鏡
if (pv.filters && typeof (pv.filters.item) === 'function') {
pv.filters.item("DXImageTransform.Microsoft.AlphaImageLoader").src = el.value;
} else {
// 其他瀏覽器與 IE10+ 走 FileReader
var fr = new FileReader();
fr.onload = function (evt) {
var pvImg = new Image();
pvImg.style.width = pv.offsetWidth + 'px';
pvImg.style.height = pv.offsetHeight + 'px';
pvImg.src = evt.target.result;
pv.removeChild(0);
pv.appendChild(pvImg);
};
fr.readAsDataURL(el.files[0]);
}
};
基於安全考量,IE11 無法透過 value、outerHTML 或 getAttribute 取得使用者選取檔案的真實路徑,只能拿到 C:\fakepath\檔名。因此若使用 IE11 卻把文件模式設為 10 以下,預覽就會失效。
解法一:在 head 中加入 <meta http-equiv="X-UA-Compatible" content="IE=Edge">,讓 IE 以當前最高版本來解析渲染。
解法二:改用 document.selection.createRangeCollection() 取得真實路徑:
// 假設 fileEl 就是 [type=file] 元素 fileEl.select(); var filePath = document.selection.createRangeCollection()[0].htmlText;
readAsDataURL 會產生一大串 base64 字串,圖片越大字串越長,頁面一旦 reflow 就可能拖慢效能。兩個改善方向:一是讓預覽的 img 使用絕對定位脫離文件流;二是改用 window.URL.createObjectURL(Blob) 產生 blob URL。
var createObjectURL = function (blob) {
return window[window.webkitURL ? 'webkitURL' : 'URL']['createObjectURL'](blob);
};
注意:createObjectURL 產生的連結獨佔記憶體,用完必須主動釋放,否則會累積;重新整理頁面時瀏覽器會自動回收。
var resolveObjectURL = function (blob) {
window[window.webkitURL ? 'webkitURL' : 'URL']['revokeObjectURL'](blob);
};
整體而言,現在的專案可以直接用 createObjectURL 這條路,FileReader 與 IE 濾鏡則作為理解原理與處理老舊環境的參考。