HTML 5中的文件處理之FileAPI
在眾多HTML5規范中,有一部分規范是跟文件處理有關的,在早期的瀏覽器技術中,處理小量字符串是js最擅長的處理之一。但文件處理,尤其是二進制文件處理,一直是個空白。在一些情況下,我們不得不通過Flash/ActiveX/NP插件或云端的服務器處理較為復雜或底層的數據。今天,HTML5的一系列新規范正在致力于讓瀏覽器具備更強大的文件處理能力。
今天要介紹的FileAPI,就是為解決這類問題而生的。
總覽
FileAPI是一些列文件處理規范的基礎,包含最基礎的文件操作的JavaScript接口設計。其中最主要的接口定義一共有4個:
◆ FileList接口: 可以用來代表一組文件的JS對象,比如用戶通過input[type="file"]元素選中的本地文件列表
◆ Blob接口: 用來代表一段二進制數據,并且允許我們通過JS對其數據以字節為單位進行“切割”
◆ File接口: 用來代步一個文件,是從Blob接口繼承而來的,并在此基礎上增加了諸如文件名、MIME類型之類的特性
◆ FileReader接口: 提供讀取文件的方法和事件
這里有兩點細節需要注意:
1. 我們平時使用input[type="file"]元素都是選中單個文件,其本身是允許同時選中多個文件的,所以會用到FileList
2. Blob接口和File接口可以返回數據的字節數等信息,也可以“切割”,但無法獲取真正的內容,這也正是FileReader存在的意義,而文件大小不一時,讀取文件可能存在明顯的時間花費,所以我們用異步的方式,通過觸發另外的事件來返回讀取到的文件內容
接口描述
這4個接口其實并不復雜,也很好理解(接口中的“#Foo”表示任意Foo類型的對象):
FileList接口
- #FileList[index] // 得到第index個文件
Blob接口
- #Blob.size // 只讀特性,數據的字節數
- #Blob.slice(start, length) // 將當前文件切割并將結果返回
File接口
- #File.size // 繼承自Blob,意義同上
- #File.slice(start, length) // 繼承自Blob,意義同上
- #File.name // 只讀屬性,文件名
- #File.type // 只讀屬性,文件的MIME類型
- #File.urn // 只讀屬性,代表該文件的URN,幾乎用不到,暫且無視
FileReader方法
- #FileReader.readAsBinaryString(blob/file) // 以二進制格式讀取文件內容
- #FileReader.readAsText(file, [encoding]) // 以文本(及字符串)格式讀取文件內容,并且可以強制選擇文件編碼
- #FileReader.readAsDataURL(file) // 以DataURL格式讀取文件內容
- #FileReader.abort() // 終止讀取操作
FileReader事件
- #FileReader.onloadstart // 讀取操作開始時觸發
- #FileReader.onload // 讀取操作成功時觸發
- #FileReader.onloadend // 讀取操作完成時觸發(不論成功還是失敗)
- #FileReader.onprogress // 讀取操作過程中觸發
- #FileReader.onabort // 讀取操作被中斷時觸發
- #FileReader.onerror // 讀取操作失敗時觸發
FileReader屬性
- #FileReader.result // 讀取的結果(二進制、文本或DataURL格式)
- #FileReader.readyState // 讀取操作的狀態(EMPTY、LOADING、DONE)
代碼示例
舉例一:控制file控件,讀取其中的第二個文件,并將其文本內容在控制臺輸出
- var input = document.querySelector('input[type="file"]'); // 找到***個file控件
- var firstFile = input.files[0]; // file控件的files特性其實就是一個FileList類型的對象
- var secondFile = input.files[1]; // 當file控件的multiple特性為true時,我們可以同時選擇多個文件,通過input.files[n]可以按序訪問這些文件
- var reader = new FileReader(); // 新建一個FileReader類型的對象
- reader.readAsText(secondFile); // 按文本格式讀取file控件中的第二個文件
- reader.onloadend = function (e) { // 綁定讀取操作完成的事件
- console.log(reader.result); // 取得讀取結果并輸出
- };
舉例二:給一個含utf-8編碼的文本文件file去掉BOM頭信息
- var size = file.size; // 先取得文件總字節數
- var result = file.slice(3, size - 3); // 用slice方法去掉開頭的3個字節
***,對FileAPI實踐的三點注意
1. 由于規范尚未截稿,#File.urn尚存較大變數,webkit并未實現此特性
2. #Blob.slice在webkit內核中加入了前綴,即#Blob.webkitSlice,且第二個參數不是“length”,而是“end”,話句話說,上面的示例二應改為file.webkitSlice(3, size)才能生效
3. 規范中還明確規定了各種出錯處理和異常處理,這些內容是同樣重要的:不論對于一套完備的規范,還是對于一個健壯的程序而言。由于篇幅有限,這部分就不細說了,大家可以在W3C官網自由查閱
以上就是FileAPI的簡單介紹。萬丈高樓平地起,后面的文件操作會更神奇更有趣。
原文:http://bulaoge.net/topic.blg?dmn=g3g4&tid=2344378#Content
【編輯推薦】