先前幾篇已經分享過拖放、內容可編輯與本地儲存的範例。這次要談的是另一塊拼圖:用 FileReader 讀取使用者本機的檔案。
寫那些範例時我一直在想一件事——如果只是把 API 拿出來演示一遍,意義有限。真正有價值的是示範這些新特性怎麼組裝成一個「真的有人會用」的功能。所以這次做了一個小畫板:你可以把圖片直接從桌面拖進來,也可以用檔案選擇框挑一張,讀取後立刻在頁面上預覽。
在 HTML5 裡,從網頁存取本機檔案變得相當直接。File 規格定義了幾個彼此搭配的介面:
<input type="file"> 提供。頁面上有一塊畫板,你可以從本機拖一張圖片進去,或改用檔案選擇框挑選。範例中我沒有加檔案過濾與型別檢查,所以請自行只選圖片檔。
另外提醒:當時並沒有任何瀏覽器完整實作 HTML5,這個範例需要在支援的瀏覽器上執行(例如 Firefox 3.5 以上)。
整個流程其實很短:
function imagesSelected(myFiles) {
for (var i = 0, f; f = myFiles[i]; i++) {
var imageReader = new FileReader();
imageReader.onload = (function (aFile) {
return function (e) {
var span = document.createElement('span');
span.innerHTML = ['<img class="images" src="',
e.target.result, '" title="',
aFile.name, '" />'].join('');
document.getElementById('thumbs').insertBefore(span, null);
};
})(f);
imageReader.readAsDataURL(f);
}
}
function dropIt(e) {
imagesSelected(e.dataTransfer.files);
e.stopPropagation();
e.preventDefault();
}
幾個值得留意的設計細節:
第一,readAsDataURL() 會把檔案讀成 base64 編碼的 data URL,這個字串可以直接塞進 <img> 的 src,不需要先上傳到伺服器。這正是能在瀏覽器端完成預覽的關鍵。
第二,onload 的處理函式用 IIFE 包了一層並把 f 傳進去。如果不這麼做,迴圈裡的閉包會共用同一個 f,最後所有圖片都會顯示成最後一張。這是迴圈搭配非同步回呼的經典陷阱。
第三,dropIt 裡呼叫了 stopPropagation() 與 preventDefault()。少了這兩行,瀏覽器會把拖入的檔案當成導航行為,直接把頁面導向那個檔案。
我把 ondrop 放在儲存格上,並一併關掉 dragenter 與 dragover 的預設行為:
<td align="left" height="105"
ondragenter="return false"
ondragover="return false"
ondrop="dropIt(event)">
<output id="thumbs"></output>
</td>
ondragover 一定要回傳 false,否則瀏覽器根本不會觸發 drop,你的放物區會毫無反應。
這個範例只示範了把本機檔案拖進畫板這一件事,但我想它足以說明 File API 的能力輪廓:讀取、編碼、渲染,全在瀏覽器端完成,一行伺服器程式都不用寫。往上延伸,你可以做純前端的圖片裁切、批次轉檔、離線文件預覽——資料不必離開使用者的機器,這既是效能優勢,也是隱私優勢。