#HuploadifyV2.0 ###支持断点续传功能的HTML5文件上传插件
jQuery文件上传插件,HTML5版uploadify,保持与uploadify一致的API,完全山寨。Uploadify官网:http://www.uploadify.com/
在V2.0版本中,实现了文件的断点续传功能,这样在上传大文件的时候,就不用担心中途中断后重新从头再上传的麻烦了。为满足最大的灵活性,保存已上传文件大小和获取已上传文件大小的函数将由你来定义,你可以使用localStorage保存在本地,或者发送ajax请求保存在服务器上。
#####已实现的特性有:
- 多文件上传
- 显示进度条
- 显示已上传文件大小和百分比
- 文件后缀名和文件大小检测
- 向服务端提交额外数据
- 自定义文件队列中的html模板
- css样式分离出单独文件,可自己定制样式
- 添加文件上传各阶段的回调函数
- 断点续传
#####已实现常用的API,default配置信息如下: fileTypeExts:'.',//允许上传的文件类型,格式'.jpg;.doc' uploader:'',//文件提交的地址 auto:false,//是否开启自动上传 method:'post',//发送请求的方式,get或post multi:true,//是否允许选择多个文件 formData:null,//发送给服务端的参数,格式:{key1:value1,key2:value2} fileObjName:'file',//在后端接受文件的参数名称,如PHP中的$_FILES['file'] fileSizeLimit:2048,//允许上传的文件大小,单位KB showUploadedPercent:true,//是否实时显示上传的百分比,如20% showUploadedSize:false,//是否实时显示已上传的文件大小,如1M/2M buttonText:'选择文件',//上传按钮上的文字 removeTimeout: 1000,//上传完成后进度条的消失时间,单位毫秒 itemTemplate:itemTemp,//上传队列显示的模板 breakPoints:false,//是否开启断点续传 fileSplitSize:10241024,//断点续传的文件块大小,单位Byte,默认1M getUploadedSize:null,//类型:function,自定义获取已上传文件的大小函数,用于开启断点续传模式,可传入一个参数file,即当前上传的文件对象,需返回number类型 saveUploadedSize:null,//类型:function,自定义保存已上传文件的大小函数,用于开启断点续传模式,可传入两个参数:file:当前上传的文件对象,value:已上传文件的大小,单位Byte onUploadStart:null,//上传开始时的动作 onUploadSuccess:null,//上传成功的动作 onUploadComplete:null,//上传完成的动作 onUploadError:null, //上传失败的动作 onInit:null,//初始化时的动作 onCancel:null//删除掉某个文件后的回调函数,可传入参数file onClearQueue:null,//清空上传队列后的回调函数,在调用cancel并传入参数时触发 onDestroy:null,//在调用destroy方法时触发 onSelect:null,//选择文件后的回调函数,可传入参数file onQueueComplete:null//队列中的所有文件上传完成后触发 #####使用方法
断点续传功能依赖四个配置参数,分别是: breakPoints : ture|false 是否开启断点续传,如果设为false,则插件与1.0版本表现一致。 fileSplitSize : number 断点续传的文件块大小,单位Byte,默认1M getUploadedSize : function 自定义获取已上传文件的大小函数,用于开启断点续传模式,可传入一个参数file,即当前上传的文件对象,需返回number类型 saveUploadedSize : function 类型:function,自定义保存已上传文件的大小函数,用于开启断点续传模式,可传入两个参数:file:当前上传的文件对象,value:已上传文件的大小,单位Byte
下面是简单的使用localStorage进行断点本地保存的示例。首先页面上需要一个容器,通常是一个div,如:
<div id="upload"></div>
然后调用插件即可:
$('#upload').Huploadify({
auto:true,
fileTypeExts:'*.jpg;*.png;*.exe',
multi:true,
formData:{key:123456,key2:'vvvv'},
fileSizeLimit:1024,
showUploadedPercent:true,
showUploadedSize:true,
removeTimeout:9999999,
uploader:'upload.php',
breakPoints:true,
fileSplitSize:1024*1024,
getUploadedSize:function(file){
var size = parseInt(localStorage.getItem(file.name)) || 0;
return size;
},
saveUploadedSize:function(file, value){
localStorage.setItem(file.name, value);
},
onUploadStart:function(file){
console.log(file.name+'开始上传');
},
onInit:function(obj){
console.log('初始化');
console.log(obj);
},
onUploadComplete:function(file){
console.log(file.name+'上传完成');
},
onCancel:function(file){
console.log(file.name+'删除成功');
},
onClearQueue:function(queueItemCount){
console.log('有'+queueItemCount+'个文件被删除了');
},
onDestroy:function(){
console.log('destroyed!');
},
onSelect:function(file){
console.log(file.name+'加入上传队列');
},
onQueueComplete:function(queueData){
console.log('队列中的文件全部上传完成',queueData);
}
});
具体的API使用方式,可参考uploadify官网,完全是参照它的API来的。
更多详细说明,欢迎访问我的博客:http://www.cnblogs.com/lvdabao/p/3452858.html