檔案上傳已是各類網站的標配,無論是影片平台還是社群媒體都離不開它。但過去用 HTML 表單上傳有個先天限制:你想知道使用者選的檔案有哪些屬性,只能等它上傳完成後才能得知。
把未知內容直接丟到伺服器,可能衍生安全問題,也可能因為體積過大而浪費空間與頻寬。HTML5 帶來的 FileReader API 正好解決這一點——在使用者按下上傳之前,就能取得檔案的基本資訊。
FileReader 的工作原理與 File API 一致,都需要搭配 input[type="file"] 元素:
<!-- 一個能上傳多媒體文件的表單 --> <input type="file" id="upload-file" multiple /> <!-- 顯示圖片的地方 --> <div id="destination"></div>
關於可讀取的檔案屬性(路徑、大小、尺寸、類型等),可參考 File API 的相關說明。
以下範例讓使用者選擇圖片後立即在頁面上預覽:
document.getElementById('upload-file').addEventListener('change', function() {
var file;
var destination = document.getElementById('destination');
destination.innerHTML = '';
for(var x = 0, xlen = this.files.length; x < xlen; x++) {
file = this.files[x];
if(file.type.indexOf('image') != -1) {
var reader = new FileReader();
reader.onload = function(e) {
var img = new Image();
img.src = e.target.result;
destination.appendChild(img);
};
reader.readAsDataURL(file);
}
}
});
這裡用 readAsDataURL 把圖片轉成 base64 字串,再以 data URI 的方式直接顯示。FileReader 另外還提供 readAsText、readAsArrayBuffer 與 readAsBinaryString 等讀取方式,可依檔案類型選擇。
有了 FileReader,許多原本必須上傳後才能做的處理都能提前到瀏覽器端完成,例如尺寸檢查、格式攔截與即時預覽,對使用者體驗與伺服器負擔都是雙贏。