Uploadify参数详解
属性
|
$('#file_upload').uploadify({
//一属性详解
id: jQuery(this).attr('id'),//绑定的input的ID
langFile:'/assets/uploadify/uploadifyLang_en.js',//语言包的路径，能设置所有的提示文字
swf: '/assets/uploadify/uploadify.swf',//[必须设置]swf的路径
uploader: '/jsp/upload/upload.action',//[必须设置]处理上传动作的的url
auto:false,//文件选择完成后，是否自动上传
buttonText:'上传附件',//上传按钮的文字
height: 30,//上传按钮的高和宽
width: 120,
formData:{},//JSON格式上传每个文件的同时提交到服务器的额外数据，可在’onUploadStart’事件中使用’settings’方法动态设置。
buttonCursor: 'pointer',//上传鼠标hover后Cursor的形状
cancelImage: 'http://www.static-xxx.nu/uploadify-cancel.png',//[必须设置]取消图片的路径
checkExisting:'/uploader/uploadify-check-existing.action',//检查上传文件是否存，触发的url，返回1/0
debug: true,//如果设置为true则表示启用SWFUpload的调试模式
fileObjName:'file',//文件上传对象的名称
fileSizeLimit : 0,//文件的极限大小，以字节为单位，0为不限制。1MB:1*1024*1024
fileTypeDesc: 'Bild JPG',//允许上传的文件类型的描述，在弹出的文件选择框里会显示
fileTypeExts: '*.jpg',//允许上传的文件类型，限制弹出文件选择框里能选择的文件
method: 'post',//和后台交互的方式：post/get
multi: true,//是否能选择多个文件
itemTemplate:false,//用于设置上传队列的HTML模版，可以使用以下标签：instanceID – Uploadify实例的IDfileID – 列队中此文件的ID,或者理解为此任务的IDfileName – 文件的名称fileSize – 当前上传文件的大小插入模版标签时使用格式如：${fileName}
queueID: 'fileQueue',//设置上传队列容器DOM元素的ID，如果为false则自动生成一个队列容器。
queueSizeLimit : 999,//队列最多显示的任务数量，如果选择的文件数量超出此限制，将会出发onSelectError事件。 注意此项并非最大文件上传数量，如果要限制最大上传文件数量，应设置uploadLimit。
progressData : 'all', // 'percentage''speed''all'//队列中显示文件上传进度的方式：all-上传速度+百分比，percentage-百分比，speed-上传速度
removeCompleted : true,//是否自动将已完成任务从队列中删除，如果设置为false则会一直保留此任务显示。
removeTimeout: 3,//如果设置了任务完成后自动从队列中移除，则可以规定从完成到被移除的时间间隔。
requeueErrors : true,//如果设置为true，则单个任务上传失败后将返回错误，并重新加入任务队列上传。
postData: {},//和后台交互时，附加的参数
preventCaching : true,//如果为true，则每次上传文件时自动加上一串随机字符串参数，防止URL缓存影响上传结果
transparent: true,
overrideEvents:['onUploadProgress','',''],//设置哪些事件可以被重写，JSON格式，如：’overrideEvents’ : ['onUploadProgress']
successTimeout : 30,//文件上传成功后服务端应返回成功标志，此项设置返回结果的超时时间
timeoutuploadLimit:999,//能同时上传的文件数目
uploadLimit:11,//最大上传文件数量，如果达到或超出此限制将会触发onUploadError事件。
//二事件详解
onCancel:function(file){//当点击文件队列中文件的关闭按钮或点击取消上传时触发，file参数为被取消上传的文件对象
alert( 'id: ' + file.id//队列中的id（如 SWFUpload_0_1）,在进度条显示的时候，对应文件进度条的id，可以控制显隐
+ ' - 索引: ' + file.index// SWFUpload_0_1 后面的1
+ ' - 文件名: ' + file.name
+ ' - 文件大小: ' + file.size
+ ' - 类型: ' + file.type
+ ' - 创建日期: ' + file.creationdate
+ ' - 修改日期: ' + file.modificationdate
+ ' - 文件状态: ' + file.filestatus);
},
onClearQueue:function(queueItemCount){//当调用函数cancel方法时触发，
//queueItemCount参数为被取消上传的文件数量。
alert('取消上传文件的数量：'+queueItemCount)；
},
onDestroy:function(){//当destory方法被调用时触发
},
onDisable:function(){//当disable方法禁用Uploadify上传按钮时被调用时触发。
},
onEnable:function(){//当disable方法启用Uploadify上传按钮时被调用时触发。
},
onFallback:function(){//当Uploadify初始化过程中检测到当前浏览器不支持flash时触发。
},
onInit:function(){// 首次初始化Uploadify结束时触发。
},
onDialogClose : function(swfuploadifyQueue) {//当文件选择对话框关闭时触发
if( swfuploadifyQueue.filesErrored > 0 ){
alert( '添加至队列时有'
+swfuploadifyQueue.filesErrored
+'个文件发生错误n'
+'错误信息:'
+swfuploadifyQueue.errorMsg
+'n选定的文件数:'
+swfuploadifyQueue.filesSelected
+'n成功添加至队列的文件数:'
+swfuploadifyQueue.filesQueued
+'n队列中的总文件数量:'
+swfuploadifyQueue.queueLength);
};
},
onDialogOpen : function() {//当选择文件对话框打开时触发
alert( 'Open!');
},
onSWFReady:function(){//Flash文件载入成功后触发。
},
onSelect : function(file) {//当每个文件添加至队列后触发
alert( 'id: ' + file.id//队列中的id（如 SWFUpload_0_1）,在进度条显示的时候，对应文件进度条的id，可以控制显隐
+ ' - 索引: ' + file.index// SWFUpload_0_1 后面的1
+ ' - 文件名: ' + file.name
+ ' - 文件大小: ' + file.size
+ ' - 类型: ' + file.type
+ ' - 创建日期: ' + file.creationdate
+ ' - 修改日期: ' + file.modificationdate
+ ' - 文件状态: ' + file.filestatus);
},
onSelectError : function(file,errorCode,errorMsg) {//当文件选定发生错误时触发
alert( 'id: ' + file.id//队列中的id（如 SWFUpload_0_1）,在进度条显示的时候，对应文件进度条的id，可以控制显隐
+ ' - 索引: ' + file.index// SWFUpload_0_1 后面的1
+ ' - 文件名: ' + file.name
+ ' - 文件大小: ' + file.size
+ ' - 类型: ' + file.type
+ ' - 创建日期: ' + file.creationdate
+ ' - 修改日期: ' + file.modificationdate
+ ' - 文件状态: ' + file.filestatus
+ ' - 错误代码: ' + errorCode
+ ' - 错误信息: ' + errorMsg
);
},
onQueueComplete : function(stats) {//当队列中的所有文件全部完成上传时触发
alert( '成功上传的文件数: ' + stats.successful_uploads
+ ' - 上传出错的文件数: ' + stats.upload_errors
+ ' - 取消上传的文件数: ' + stats.upload_cancelled
+ ' - 出错的文件数' + stats.queue_errors
);
},
onUploadComplete : function(file,swfuploadifyQueue) {//每个文件上传完毕后无论成功与否都会触发一次
alert( 'id: ' + file.id//队列中的id（如 SWFUpload_0_1）,在进度条显示的时候，对应文件进度条的id，可以控制显隐
+ ' - 索引: ' + file.index// SWFUpload_0_1 后面的1
+ ' - 文件名: ' + file.name
+ ' - 文件大小: ' + file.size
+ ' - 类型: ' + file.type
+ ' - 创建日期: ' + file.creationdate
+ ' - 修改日期: ' + file.modificationdate
+ ' - 文件状态: ' + file.filestatus
+ ' - 出错的文件数: ' + swfuploadifyQueue.filesErrored
+ ' - 错误信息: ' + swfuploadifyQueue.errorMsg
+ ' - 要添加至队列的数量: ' + swfuploadifyQueue.filesSelected
+ ' - 添加至对立的数量: ' + swfuploadifyQueue.filesQueued
+ ' - 队列长度: ' + swfuploadifyQueue.queueLength);
},
onUploadError : function(file,errorCode,errorMsg,errorString,swfuploadifyQueue) {//上传文件出错是触发（每个出错文件触发一次）
alert( 'id: ' + file.id//队列中的id（如 SWFUpload_0_1）,在进度条显示的时候，对应文件进度条的id，可以控制显隐
+ ' - 索引: ' + file.index// SWFUpload_0_1 后面的1
+ ' - 文件名: ' + file.name
+ ' - 文件大小: ' + file.size
+ ' - 类型: ' + file.type
+ ' - 创建日期: ' + file.creationdate
+ ' - 修改日期: ' + file.modificationdate
+ ' - 文件状态: ' + file.filestatus
+ ' - 错误代码: ' + errorCode
+ ' - 错误描述: ' + errorMsg
+ ' - 简要错误描述: ' + errorString
+ ' - 出错的文件数: ' + swfuploadifyQueue.filesErrored
+ ' - 错误信息: ' + swfuploadifyQueue.errorMsg
+ ' - 要添加至队列的数量: ' + swfuploadifyQueue.filesSelected
+ ' - 添加至对立的数量: ' + swfuploadifyQueue.filesQueued
+ ' - 队列长度: ' + swfuploadifyQueue.queueLength);
},
onUploadProgress : function(file,fileBytesLoaded,fileTotalBytes,
queueBytesLoaded,swfuploadifyQueueUploadSize) {//上传进度发生变更时触发
alert( 'id: ' + file.id//队列中的id（如 SWFUpload_0_1）,在进度条显示的时候，对应文件进度条的id，可以控制显隐
+ ' - 索引: ' + file.index// SWFUpload_0_1 后面的1
+ ' - 文件名: ' + file.name
+ ' - 文件大小: ' + file.size
+ ' - 类型: ' + file.type
+ ' - 创建日期: ' + file.creationdate
+ ' - 修改日期: ' + file.modificationdate
+ ' - 文件状态: ' + file.filestatus
+ ' - 当前文件已上传的字节数: ' + fileBytesLoaded
+ ' - 文件总字节数: ' + fileTotalBytes
+ ' - 当前任务队列中全部文件已上传的总字节数: ' + queueBytesLoaded
+ ' - 当前任务队列中全部文件的总字节数: ' + swfuploadifyQueueUploadSize
);
},
onUploadStart: function(file) {//上传开始时触发（每个文件触发一次）
alert( 'id: ' + file.id //队列中的id（如 SWFUpload_0_1）,在进度条显示的时候，对应文件进度条的id，可以控制显隐
+ ' - 索引: ' + file.index // SWFUpload_0_1 后面的1
+ ' - 文件名: ' + file.name
+ ' - 文件大小: ' + file.size
+ ' - 类型: ' + file.type
+ ' - 创建日期: ' + file.creationdate
+ ' - 修改日期: ' + file.modificationdate
+ ' - 文件状态: ' + file.filestatus
);
},
onUploadSuccess : function(file,data,response) {//当文件上传成功时触发，每个文件会触发一次
//file 文件对象
alert( 'id: ' + file.id //队列中的id（如 SWFUpload_0_1）,在进度条显示的时候，对应文件进度条的id，可以控制显隐
+ ' - 索引: ' + file.index // SWFUpload_0_1 后面的1
+ ' - 文件名: ' + file.name
+ ' - 文件大小: ' + file.size
+ ' - 类型: ' + file.type
+ ' - 创建日期: ' + file.creationdate
+ ' - 修改日期: ' + file.modificationdate
+ ' - 文件状态: ' + file.filestatus
+ ' - 服务器端消息: ' + data//服务端返回的信息
+ ' - 是否上传成功: ' + response //有输出时为true,如果无响应为false，如果返回的是false,当超过successTimeout设置的时间后假定为true
);
}
});
|
三、方法
|
1
2
3
|
cancel(fileID, suppressEvent)//取消队列中的任务，不管此任务是否已经开始上传
// fileID – 要取消的文件ID，如果为空则取消队列中第一个任务，如果为'*'则取消所有任务
// suppressEvent – 是否阻止触发onUploadCancel事件，当清空队列时非常实用。
|
|
1
2
3
|
<a href="javascript:$('#file_upload').uploadify('cancel')">取消第一个</a>
<a href="javascript:$('#file_upload').uploadify('cancel', '*')">清空队列</a>
<a href="javascript:$('#file_upload').uploadify('upload', '*')">开始上传所有任务</a>
|
|
1
2
|
destroy()
//销毁Uploadify实例并将文件上传按钮恢复到原始状态
|
|
1
|
<a href="javascript:$('#file_upload').uploadify('destroy')">销毁Uploadify实例</a>
|
|
1
2
|
disable(setDisabled)// 禁用或启用文件浏览按钮
// setDisabled – 设置为true表示禁用，false为启用
|
|
1
2
|
<a href="javascript:$('#file_upload').uploadify('disable', true)">禁用按钮</a>
<a href="javascript:$('#file_upload').uploadify('disable', false)">启用按钮</a>
|
|
1
2
3
4
|
settings(name, value, resetObjects)//获取或设置Uploadify实例参数
// name – 属性名称，如果只提供属性名称则表示获取其值
// value – 属性值
// resetObjects – 设置为true时，更新postData对象将清空现有的值。否则，新的值将被添加到其末尾。
|
|
1
2
|
$('#file_upload').uploadify('settings','buttonText','BROWSE');//设置上传按钮的文字
$('#file_upload').uploadify('settings','buttonText'));//获取上传按钮名称的文字
|
|
1
|
stop()//停止当前正在上传的任务
|
|
1
2
|
<a href="javascript:$('#file_upload').uploadify('upload', '*')">开始上传</a>
<a href="javascript:$('#file_upload').uploadify('stop')">停止上传</a>
|
|
1
|
upload(fileID)// 立即上传指定的文件，如果fileID为'*'表示上传所有文件，要指定上传多个文件，则将每个文件的fileID作为一个参数
|
|
1
|
<a href="javascript:$('#file_upload').uploadify('upload','*')">开始上传所有文
|
