js中FileReader()用法

HTML5定義了FileReader作爲文件API的重要成員用於讀取文件,根據W3C的定義,FileReader接口提供了讀取文件的方法和包含讀取結果的事件模型。


FileReader的使用方式非常簡單,可以按照如下步驟創建FileReader對象並調用其方法:

1.檢測瀏覽器對FileReader的支持

  1. if(window.FileReader) {
  2. var fr = new FileReader();
  3. // add your code here
  4. }
  5. else {
  6. alert("Not supported by your browser!");
  7. }


2. 調用FileReader對象的方法

FileReader 的實例擁有 4 個方法,其中 3 個用以讀取文件,另一個用來中斷讀取。下面的表格列出了這些方法以及他們的參數和功能,需要注意的是 ,無論讀取成功或失敗,方法並不會返回讀取結果,這一結果存儲在 result屬性中。

方法名 參數 描述
abort none 中斷讀取
readAsBinaryString file 將文件讀取爲二進制碼
readAsDataURL file 將文件讀取爲 DataURL
readAsText file, [encoding] 將文件讀取爲文本

readAsText:該方法有兩個參數,其中第二個參數是文本的編碼方式,默認值爲 UTF-8。這個方法非常容易理解,將文件以文本方式讀取,讀取的結果即是這個文本文件中的內容。
readAsBinaryString:該方法將文件讀取爲二進制字符串,通常我們將它傳送到後端,後端可以通過這段字符串存儲文件。
readAsDataURL:這是例子程序中用到的方法,該方法將文件讀取爲一段以 data: 開頭的字符串,這段字符串的實質就是 Data URL,Data URL是一種將小文件直接嵌入文檔的方案。這裏的小文件通常是指圖像與 html 等格式的文件。


3. 處理事件

FileReader 包含了一套完整的事件模型,用於捕獲讀取文件時的狀態,下面這個表格歸納了這些事件。

事件 描述
onabort 中斷時觸發
onerror 出錯時觸發
onload 文件讀取成功完成時觸發
onloadend 讀取完成觸發,無論成功或失敗
onloadstart 讀取開始時觸發
onprogress 讀取中

文件一旦開始讀取,無論成功或失敗,實例的 result 屬性都會被填充。如果讀取失敗,則 result 的值爲 null ,否則即是讀取的結果,絕大多數的程序都會在成功讀取文件的時候,抓取這個值。

  1. fr.onload = function() {
  2. this.result;
  3. };


下面通過一個上傳圖片預覽和帶進度條上傳來展示FileReader的使用。

  1. <script type="text/javascript">
  2. function showPreview(source) {
  3. var file = source.files[0];
  4. if(window.FileReader) {
  5. var fr = new FileReader();
  6. fr.onloadend = function(e) {
  7. document.getElementById("portrait").src = e.target.result;
  8. };
  9. fr.readAsDataURL(file);
  10. }
  11. }
  12. </script>
  13. <input type="file" name="file" onchange="showPreview(this)" />
  14. <img id="portrait" src="" width="70" height="75">

如果要限定上傳文件的類型,可以通過文件選擇器獲取文件對象並通過type屬性來檢查文件類型

  1. if(!/image\/\w+/.test(file.type)){
  2. alert("請確保文件爲圖像類型");
  3. return false;
  4. }

不難發現這個檢測是基於正則表達式的,因此可以進行各種複雜的匹配,非常有用。

如果要增加一個進度條,可以使用HTML 5的progress標籤,通過下面的代碼實現。

  1. <form>
  2. <fieldset>
  3. <legend>分度讀取文件:</legend>
  4. <input type="file" id="File" />
  5. <input type="button" value="中斷" id="Abort" />
  6. <p>
  7. <label>讀取進度:</label><progress id="Progress" value="0" max="100"></progress>
  8. </p>
  9. <p id="Status"></p>
  10. </fieldset>
  11. </form>

  1. var h = {
  2. init: function() {
  3. var me = this;
  4. document.getElementById('File').onchange = me.fileHandler;
  5. document.getElementById('Abort').onclick = me.abortHandler;
  6. me.status = document.getElementById('Status');
  7. me.progress = document.getElementById('Progress');
  8. me.percent = document.getElementById('Percent');
  9. me.loaded = 0;
  10. //每次讀取1M
  11. me.step = 1024 * 1024;
  12. me.times = 0;
  13. },
  14. fileHandler: function(e) {
  15. var me = h;
  16. var file = me.file = this.files[0];
  17. var reader = me.reader = new FileReader();
  18. //
  19. me.total = file.size;
  20. reader.onloadstart = me.onLoadStart;
  21. reader.onprogress = me.onProgress;
  22. reader.onabort = me.onAbort;
  23. reader.onerror = me.onerror;
  24. reader.onload = me.onLoad;
  25. reader.onloadend = me.onLoadEnd;
  26. //讀取第一塊
  27. me.readBlob(file, 0);
  28. },
  29. onLoadStart: function() {
  30. var me = h;
  31. },
  32. onProgress: function(e) {
  33. var me = h;
  34. me.loaded += e.loaded;
  35. //更新進度條
  36. me.progress.value = (me.loaded / me.total) * 100;
  37. },
  38. onAbort: function() {
  39. var me = h;
  40. },
  41. onError: function() {
  42. var me = h;
  43. },
  44. onLoad: function() {
  45. var me = h;
  46. if(me.loaded < me.total) {
  47. me.readBlob(me.loaded);
  48. } else {
  49. me.loaded = me.total;
  50. }
  51. },
  52. onLoadEnd: function() {
  53. var me = h;
  54. },
  55. readBlob: function(start) {
  56. var me = h;
  57. var blob,
  58. file = me.file;
  59. me.times += 1;
  60. if(file.webkitSlice) {
  61. blob = file.webkitSlice(start, start + me.step + 1);
  62. } else if(file.mozSlice) {
  63. blob = file.mozSlice(start, start + me.step + 1);
  64. }
  65. me.reader.readAsText(blob);
  66. },
  67. abortHandler: function() {
  68. var me = h;
  69. if(me.reader) {
  70. me.reader.abort();
  71. }
  72. }
  73. };
  74. h.init();


發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章