HTML5之FileReader的使用

举报
SHQ5785 发表于 2024/03/08 09:04:11 2024/03/08
【摘要】 ​​一、前言HTML5定义了FileReader作为文件API的重要成员用于读取文件，根据W3C的定义，FileReader接口提供了读取文件的方法和包含读取结果的事件模型。FileReader的使用方式非常简单，可以按照如下步骤创建FileReader对象并调用其方法：二、检测浏览器对FileReader的支持if(window.FileReader) { var fr = ne...

​

​一、前言

HTML5定义了FileReader作为文件API的重要成员用于读取文件，根据W3C的定义，FileReader接口提供了读取文件的方法和包含读取结果的事件模型。


FileReader的使用方式非常简单，可以按照如下步骤创建FileReader对象并调用其方法：

二、检测浏览器对FileReader的支持

if(window.FileReader) {  
    var fr = new FileReader();  
    // add your code here  
}  
else {  
    alert("Not supported by your browser!");  
}

三、调用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 等格式的文件。

四、处理事件

FileReader 包含了一套完整的事件模型，用于捕获读取文件时的状态，下面归纳了这些事件。

事件 描述

  • onabort 中断时触发

  • onerror 出错时触发

  • onload 文件读取成功完成时触发

  • onloadend 读取完成触发，无论成功或失败

  • onloadstart 读取开始时触发

  • onprogress 读取中

文件一旦开始读取，无论成功或失败，实例的 result 属性都会被填充。如果读取失败，则 result 的值为 null ，否则即是读取的结果，绝大多数的程序都会在成功读取文件的时候，抓取这个值。

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

下面通过一个上传图片预览和带进度条上传来展示FileReader的使用。

<script type="text/javascript">  
        function showPreview(source) {  
            var file = source.files[0];  
            if(window.FileReader) {  
                var fr = new FileReader();  
                fr.onloadend = function(e) {  
                    document.getElementById("portrait").src = e.target.result;  
                };  
                fr.readAsDataURL(file);  
            }  
        }  
    </script>  
  <input type="file" name="file" onchange="showPreview(this)" />  
  <img id="portrait" src="" width="70" height="75">

如果要限定上传文件的类型，可以通过文件选择器获取文件对象并通过type属性来检查文件类型。

if(!/image\/\w+/.test(file.type)){  
    alert("请确保文件为图像类型");  
    return false;  
}


不难发现这个检测是基于正则表达式的，因此可以进行各种复杂的匹配，非常有用。

如果要增加一个进度条，可以使用HTML5的progress标签，通过下面的代码实现。

<form>  
    <fieldset>  
        <legend>分度读取文件：</legend>  
        <input type="file" id="File" />  
        <input type="button" value="中断" id="Abort" />  
        <p>  
            <label>读取进度：</label><progress id="Progress" value="0" max="100"></progress>  
        </p>  
        <p id="Status"></p>  
    </fieldset>  
</form>  
<script type="text/javascript">  
var h = {  
    init: function() {  
        var me = this;  
        document.getElementById('File').onchange = me.fileHandler;  
        document.getElementById('Abort').onclick = me.abortHandler;  
        me.status = document.getElementById('Status');  
        me.progress = document.getElementById('Progress');  
        me.percent = document.getElementById('Percent');   
        me.loaded = 0;  
        //每次读取1M  
        me.step = 1024 * 1024;  
        me.times = 0;  
    },  
    fileHandler: function(e) {  
        var me = h;  
        var file = me.file = this.files[0];  
        var reader = me.reader = new FileReader();  
        me.total = file.size;  
        reader.onloadstart = me.onLoadStart;  
        reader.onprogress = me.onProgress;  
        reader.onabort = me.onAbort;  
        reader.onerror = me.onerror;  
        reader.onload = me.onLoad;  
        reader.onloadend = me.onLoadEnd;  
        //读取第一块  
        me.readBlob(file, 0);  
    },  
    onLoadStart: function() {  
        var me = h;  
    },  
    onProgress: function(e) {  
        var me = h;  
        me.loaded += e.loaded;  
        //更新进度条  
        me.progress.value = (me.loaded / me.total) * 100;  
    },  
    onAbort: function() {  
        var me = h;  
    },  
    onError: function() {  
        var me = h;  
    },  
    onLoad: function() {  
        var me = h;  
        if(me.loaded < me.total) {  
            me.readBlob(me.loaded);  
        } else {  
            me.loaded = me.total;  
        }  
    },  
    onLoadEnd: function() {  
        var me = h;  
    },  
    readBlob: function(start) {  
        var me = h;  
        var blob,  
            file = me.file;  
        me.times += 1;  
        if(file.webkitSlice) {  
            blob = file.webkitSlice(start, start + me.step + 1);  
        } else if(file.mozSlice) {  
            blob = file.mozSlice(start, start + me.step + 1);  
        }  
        me.reader.readAsText(blob);  
    },  
    abortHandler: function() {  
        var me = h;  
        if(me.reader) {  
            me.reader.abort();  
        }  
    }  
};  
h.init(); 
</script>
【版权声明】本文为华为云社区用户原创内容，未经允许不得转载，如需转载请自行联系原作者进行授权。如果您发现本社区中有涉嫌抄袭的内容，欢迎发送邮件进行举报，并提供相关证据，一经查实，本社区将立刻删除涉嫌侵权内容，举报邮箱： cloudbbs@huaweicloud.com
HTML HTML5
  • 点赞
  • 收藏
  • 关注作者

评论（0）

0/1000
抱歉，系统识别当前为高风险访问，暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称，即可参与社区互动！

*长度不超过10个汉字或20个英文字符，设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符，设置后3个月内不可修改。

确认 取消

加入云驻计划，成为创作者

  • 华为云周边好礼
  • 免费体验产品
  • 特殊身份标识
  • 线下官方门票
  • 内部专家零距离
  • 与10000+优质创作者共同成长
立即加入