FileReader的使用方式非常简单,可以按照如下步骤创建FileReader对象并调用其方法:
1.检测浏览器对FileReader的支持
if() {
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 ,否则即是读取的结果,绝大多数的程序都会在成功读取文件的时候,抓取这个值。
= function() {
;
};
下面通过一个上传图片预览和带进度条上传来展示FileReader的使用。
<script type="text/javascript">
function showPreview(source) {
var file = [0];
if() {
var fr = new FileReader();
= function(e) {
("portrait").src = ;
};
(file);
}
}
</script>
<input type="file" name="file" οnchange="showPreview(this)" />
<img src="" width="70" height="75">
如果要限定上传文件的类型,可以通过文件选择器获取文件对象并通过type属性来检查文件类型
if(!/image\/\w+/.test()){
alert("请确保文件为图像类型");
return false;
}
不难发现这个检测是基于正则表达式的,因此可以进行各种复杂的匹配,非常有用。
如果要增加一个进度条,可以使用HTML 5的progress标签,通过下面的代码实现。
<form>
<fieldset>
<legend>分度读取文件:</legend>
<input type="file" />
<input type="button" value="中断" />
<p>
<label>读取进度:</label><progress value="0" max="100"></progress>
</p>
<p ></p>
</fieldset>
</form>
var h = {
init: function() {
var me = this;
('File').onchange = ;
('Abort').onclick = ;
= ('Status');
= ('Progress');
= ('Percent');
= 0;
//每次读取1M
= 1024 * 1024;
= 0;
},
fileHandler: function(e) {
var me = h;
var file = = [0];
var reader = = new FileReader();
//
= ;
= ;
= ;
= ;
= ;
= ;
= ;
//读取第一块
(file, 0);
},
onLoadStart: function() {
var me = h;
},
onProgress: function(e) {
var me = h;
+= ;
//更新进度条
= ( / ) * 100;
},
onAbort: function() {
var me = h;
},
onError: function() {
var me = h;
},
onLoad: function() {
var me = h;
if( < ) {
();
} else {
= ;
}
},
onLoadEnd: function() {
var me = h;
},
readBlob: function(start) {
var me = h;
var blob,
file = ;
+= 1;
if() {
blob = (start, start + + 1);
} else if() {
blob = (start, start + + 1);
}
(blob);
},
abortHandler: function() {
var me = h;
if() {
();
}
}
};
();