HTML5定义了FileReader作为文件API的重要成员用于读取文件,根据W3C的定义,FileReader接口提供了读取文件的方法和包含读取结果的事件模型。
FileReader的使用方式非常简单,可以按照如下步骤创建FileReader对象并调用其方法:
1、检测浏览器对FileReader的支持
if(window.FileReader) {
var fr = new FileReader();
// add your code here
}
else {
alert("Not supported by your browser!");
}
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,绝大多数的程序都会在成功读取文件的时候,抓取这个值。
fr.onload = function() {
this.result;
};
下面通过一个案例来实现功能:
HTML代码:
<input type="file" id="addImg" accept="image/*" capture="camera" />
要点说明:
- accept="image/*":接受所有格式的图片类型
- accept="image/jpg,image/jpeg,image/png,image/gif,image/bmp,image/psd,image/tif":接受自定义的格式类型
- capture="camera":调用拍照功能
JS代码:
$('#addImg').on('change',function(){
var self = this;
if(!this.files.length){
return;
}
var files = Array.prototype.slice.call(this.files); // 将arguments对象转换为Array
if(files.length > ){
alert("只可上传1张图片");
return;
}
files.forEach(function(file,i){
var reader = new FileReader();
var name = file.name; // 图片名称
var size = Math.round(file.size / ); // 图片大小 KB
if(size >= * ){
M.alert('图片不能大于20M');
return false;
}
reader.readAsDataURL(file); // 将文件读取为 DataURL
reader.onload=function(){ // 文件读取成功完成时触发
$(self).val(''); // 清空图片资源
var src = reader.result; // 图片src
// add your code here
$('img').attr('src', src);
};
});
});