FileReader 对象允许Web应用程序异步读取存储在用户计算机上的文件(或原始数据缓冲区)的内容,使用 File
或 Blob
对象指定要读取的文件或数据。
其中File对象可以是来自用户在一个<input>
元素上选择文件后返回的FileList
对象,也可以来自拖放操作生成的 DataTransfer
对象,还可以是来自在一个HTMLCanvasElement
上执行mozGetAsFile()方法后返回结果
.
1、FileReader接口的方法
FileReader接口有4个方法,其中3个用来读取文件,另一个用来中断读取。无论读取成功或失败,方法并不会返回读取结果,这一结果存储在result属性中。
方法名 | 参数 | 描述 |
---|---|---|
readAsBinaryString | file | 开始读取指定的Blob 对象或File 对象中的内容. 当读取操作完成时,readyState 属性的值会成为DONE ,如果设置了 onloadend事件处理程序,则调用之 .同时,result 属性中将包含所读取文件的原始二进制数据. |
readAsText | file,[encoding] | 开始读取指定的Blob 对象或File 对象中的内容. 当读取操作完成时,readyState 属性的值会成为DONE ,如果设置了onloadend事件处理程序,则调用之 .同时,result 属性中将包含一个字符串以表示所读取的文件内容.encoding
可选
|
readAsDataURL | file | 开始读取指定的Blob 对象或File 对象中的内容. 当读取操作完成时,readyState 属性的值会成为DONE ,如果设置了onloadend事件处理程序,则调用之 .同时,result 属性中将包含一个data: URL格式的字符串以表示所读取文件的内容. |
abort | (none) | 中止读取操作.在返回时,readyState 属性的值为DONE . |
2、FileReader的状态常量
常量名 | 值 | 描述 |
EMPTY | 0 | 还没有加载任何数据. |
LOADING | 1 | 数据正在被加载. |
DONE | 2 | 已完成全部的读取请求. |
属性名 | 类型 | 描述 |
error | DOMError | 在读取文件时发生的错误. 只读. |
readyState | unsigned short | 表明FileReader 对象的当前状态. 值为State constants中的一个. 只读 |
result | jsval | 读取到的文件内容.这个属性只在读取操作完成之后才有效,并且数据的格式取决于读取操作是由哪个方法发起的. 只读. |
4、 FileReader接口事件
FileReader接口包含了一套完整的事件模型,用于捕获读取文件时的状态。
事件 | 描述 |
onabort | 当读取操作被中止时调用. |
onerror | 当读取操作发生错误时调用. |
onloadstart | 当读取操作将要开始之前调用. |
onprogress | 在读取数据过程中周期性调用. |
onload | 当读取操作成功完成时调用. |
onloadend | 当读取操作完成时调用,不管是成功还是失败.该处理程序在onload 或者onerror之后调用 . |
文件一旦开始读取,无论成功或失败,实例的 result 属性都会被填充。如果读取失败,则 result 的值为 null ,否则即是读取的结果,绝大多数的程序都会在成功读取文件的时候,抓取这个值。
检测浏览器对FileReader的支持
if(window.FileReader) {
var fr = new FileReader();
// add your code here
}
else {
alert("Not supported by your browser!");
}
//第二种
if(typeof FileReader == 'undefined'){
alert("你的浏览器不支持FileReader接口!");
}
5、FileReader接口的实例
<script type="text/javascript">
var result=document.getElementById("result");
var file=document.getElementById("file");
//判断浏览器是否支持FileReader接口
if(typeof FileReader == 'undefined'){
result.InnerHTML="<p>你的浏览器不支持FileReader接口!</p>";
//使选择控件不可操作
file.setAttribute("disabled","disabled");
}
function readAsDataURL(){
//检验是否为图像文件
var file = document.getElementById("file").files[0];
alert(file.type + "," + file.size + "," + file.name); // file.size以byte保存
if(!/image\/\w+/.test(file.type)){
alert("看清楚,这个需要图片!");
return false;
}
var reader = new FileReader();
//将文件以Data URL形式读入页面
reader.readAsDataURL(file);
reader.οnlοad=function(e){
var result=document.getElementById("result");
//显示文件
result.innerHTML='<img src="' + this.result +'" alt="" />';
}
}
function readAsBinaryString(){
var file = document.getElementById("file").files[0];
var reader = new FileReader();
//将文件以二进制形式读入页面
reader.readAsBinaryString(file);
reader.οnlοad=function(f){
var result=document.getElementById("result");
//显示文件
result.innerHTML=this.result;
}
}
function readAsText(){
var file = document.getElementById("file").files[0];
var reader = new FileReader();
//将文件以文本形式读入页面
reader.readAsText(file);
reader.οnlοad=function(f){
var result=document.getElementById("result");
//显示文件
result.innerHTML=this.result;
}
}
</script>
<p>
<label>请选择一个文件:</label>
<input type="file" id="file" multiple/>
<input type="button" value="读取图像" οnclick="readAsDataURL()" />
<input type="button" value="读取二进制数据" οnclick="readAsBinaryString()" />
<input type="button" value="读取文本文件" οnclick="readAsText()" />
</p>
<div id="result" name="result"></div>