DIV CSS 佈局教程網

您现在的位置: DIV+CSS佈局教程網 >> 網頁腳本 >  >> HTML基礎知識 >> HTML5詳解
動手做一個 HTML5 本地檔案讀取器:FileReader 實例教學
編輯:HTML5詳解     

先前幾篇已經分享過拖放、內容可編輯與本地儲存的範例。這次要談的是另一塊拼圖:用 FileReader 讀取使用者本機的檔案。

寫那些範例時我一直在想一件事——如果只是把 API 拿出來演示一遍,意義有限。真正有價值的是示範這些新特性怎麼組裝成一個「真的有人會用」的功能。所以這次做了一個小畫板:你可以把圖片直接從桌面拖進來,也可以用檔案選擇框挑一張,讀取後立刻在頁面上預覽。

File API 的組成

在 HTML5 裡,從網頁存取本機檔案變得相當直接。File 規格定義了幾個彼此搭配的介面:

  • FileList:使用者選取的檔案集合,形同一個檔案陣列。選檔介面由 <input type="file"> 提供。
  • Blob:代表原始二進位資料,你可以從中讀取位元組。
  • File:帶有唯讀屬性的檔案描述,包含檔名、檔案類型與資料位置。
  • FileReader:提供讀取檔案的方法,以及一組對應的事件模型來接收結果。
  • FileError / FileException:定義這套規範中的錯誤條件。

如何使用這個範例

頁面上有一塊畫板,你可以從本機拖一張圖片進去,或改用檔案選擇框挑選。範例中我沒有加檔案過濾與型別檢查,所以請自行只選圖片檔。

另外提醒:當時並沒有任何瀏覽器完整實作 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 的能力輪廓:讀取、編碼、渲染,全在瀏覽器端完成,一行伺服器程式都不用寫。往上延伸,你可以做純前端的圖片裁切、批次轉檔、離線文件預覽——資料不必離開使用者的機器,這既是效能優勢,也是隱私優勢。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved