Uploadify参数详解

http://www.5ycode.com/4

$('#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

);

}

});

三、方法

cancel(fileID, suppressEvent)//取消队列中的任务，不管此任务是否已经开始上传

// fileID – 要取消的文件ID，如果为空则取消队列中第一个任务，如果为'*'则取消所有任务

// suppressEvent – 是否阻止触发onUploadCancel事件，当清空队列时非常实用。

<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>

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','*')">开始上传所有文

posted @ 2016-05-23 14:23 @夏天阅读(1689) 评论(0) 编辑收藏举报

刷新页面返回顶部

@夏天

Uploadify参数详解

公告