query上传插件uploadify参数详细分析

Uploadify Version 3.2

官网：http://www.uploadify.com/

注：文件包里有两个js分别是：jquery.uploadify.js 和 jquery.uploadify.min.js，两者其实一样，只需载入其中一个js即可。很明显jquery.uploadify.min.js是封装好了的，开发人员推荐使用前者。

Options选项设置

auto    选择文件后自动上传
buttonClass    给“浏览按钮”加css的class样式
buttonCursor    鼠标移上去形状：arrow箭头、hand手型（默认）
buttonImage    鼠标移上去变换图片
buttonText    按钮文字
checkExisting    在目录中检查文件是否已上传成功（1 ture,0 false）
debug        是否显示调试框（默认不显示false）
fileObjName    设置一个名字，在服务器处理程序中根据该名字来取上传文件的数据。默认为Filedata，$tempFile = $_FILES['Filedata']['tmp_name']
fileSizeLimit    设置允许上传文件最大值B, KB, MB, GB 比如：'fileSizeLimit' : '20MB'
fileTypeDesc    选择的文件的描述。这个字符串出现在浏览文件对话框中文件类型下拉框处。默认：All Files
fileTypeExts    允许上传的文件类型。格式：'fileTypeExts' : '*.gif; *.jpg; *.png'
formData    附带值，需要通过get or post传递的额外数据，需要结合onUploadStart事件一起使用
height        “浏览按钮”高度px
itemTemplate    <itemTemplate>节点表示显示的内容。这些内容中也可以包含绑定到控件DataSource属性中元素集合的数据。
method        上传方式。默认：post
multi        选择文件时是否可以【选择多个】。默认：可以true
overrideEvents    不执行默认的onSelect事件
preventCaching    随机缓存值默认true ，可选true和false.如果选true,那么在上传时会加入一个随机数来使每次的URL都不同,以防止缓存.但是可能与正常URL产生冲突
progressData    进度条上显示的进度:有百分比percentage和速度speed。默认百分比
queueID        给“进度条”加背景css的ID样式。文件选择后的容器ID
queueSizeLimit    允许多文件上传的数量。默认：999
removeCompleted    上传完成后队列是否自动消失。默认：true
removeTimeout    上传完成后队列多长时间后消失。默认 3秒    需要：'removeCompleted' : true,时使用
requeueErrors    队列上传出错，是否继续回滚队列，即反复尝试上传。默认：false
successTimeout    上传超时时间。文件上传完成后,等待服务器返回信息的时间(秒).超过时间没有返回的话,插件认为返回了成功。默认：30秒
swf        swf文件的路径,本文件是插件自带的,不可用其它的代替.本参数不可省略
uploader    上传处理程序URL，本参数不可省略
uploadLimit    限制总上传文件数,默认是999。指同一时间，如果关闭浏览器后重新打开又可上传。
width        “浏览按钮”宽度px

Events 事件
onCancel    当取消一个上传队列中的文件时触发,删除时触发
onClearQueue    清除队列。当'cancel'方法带着*参数时,也就是说一次全部取消的时候触发.queueItemCount是被取消的文件个数（另外的按钮）
onDestroy    取消所有的上传队列（另外的按钮）
onDialogClose    当选择文件对话框关闭时触发,不论是点的'确定'还是'取消'都会触发.如果本事件被添加进了'overrideEvents'参数中,那么如果在选择文件时产生了错误,不会有错误提示框弹出
onDialogOpen    当选择文件框被打开时触发,没有传过来的参数
onDisable    关闭上传
onEnable    开启上传
onFallback    检测FLASH失败调用
onInit        每次初始化一个队列时触发
onQueueComplete    当队列中的所有文件上传完成时触发
onSelect    当文件从浏览框被添加到队列中时触发
onSelectError    选择文件出错时触发
onSWFReady    flash准备好时触发
onUploadComplete当一个文件上传完成时触发
onUploadError    当文件上传完成但是返回错误时触发
onUploadProgress上传汇总
onUploadStart    一个文件上传之间触发（动态改变参数的值，此方法很重要，当在多文件跨服务器上传时，你要给每个文件赋值不同的OnlyKey，即修改formData数据，服务器上的文件和数据库的OnlyKey一致，必须用到此方法）

onUploadSuccess    每个上传完成并成功的文件都会触发本事件

Methods 方法
cancel        取消一个上传队列
destroy        取消所有上传队列
disable        禁止点击“浏览按钮”
settings    返回或修改一个 uploadify实例的settings值
stop        停止当前的上传并重新添加到队列中去
upload        上传指定的文件或者所有队列中的文件

uploadify多文件上传例子：

1. <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
2. <html xmlns="http://www.w3.org/1999/xhtml">
3. <head>
4. <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
5. <title>uploadify 多文件上传例子</title>
6. <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.7.1/jquery.min.js" type="text/javascript"></script>
7. <script src="jquery.uploadify-3.1.min.js" type="text/javascript"></script>
8. <link rel="stylesheet" type="text/css" href="uploadify.css">
9. <style type="text/css">
10. body {
11. font: 13px Arial, Helvetica, Sans-serif;
12. }
13. .haha{
14. color:#FFFFFF;
15. }
16. #queue {
17. background-color: #FFF;
18. border-radius: 3px;
19. box-shadow: 0 1px 3px rgba(0,0,0,0.25);
20. height: 103px;
21. margin-bottom: 10px;
22. overflow: auto;
23. padding: 5px 10px;
24. width: 300px;
25. }
26. </style>
27. </head>
30. <body>
31. <h1>Uploadify Demo</h1>
32. <form>
33. <div id="queue"></div>
34. <input id="file_upload" name="file_upload" type="file" multiple="true">
35. </form>
37. <script type="text/javascript">
38. $(function() {
39. $('#file_upload').uploadify({
40. 'debug' : false,
41. 'auto' : true, //是否自动上传,
42. 'buttonClass' : 'haha', //按钮辅助class
43. 'buttonText' : '上传图片', //按钮文字
44. 'height' : 30, //按钮高度
45. 'width' : 100, //按钮宽度
46. 'checkExisting' : 'check-exists.php',//是否检测图片存在,不检测:false
47. 'fileObjName' : 'files', //默认 Filedata, $_FILES控件名称
48. 'fileSizeLimit' : '1024KB', //文件大小限制 0为无限制默认KB
49. 'fileTypeDesc' : 'All Files', //图片选择描述
50. 'fileTypeExts' : '*.gif; *.jpg; *.png',//文件后缀限制默认：'*.*'
51. 'formData' : {'someKey' : 'someValue', 'someOtherKey' : 1},//传输数据JSON格式
52. // 'formData':{ 'albumid':$("#albumid").val() },
53. //'overrideEvents': ['onUploadProgress'], // The progress will not be updated
54. //'progressData' : 'speed', //默认percentage 进度显示方式
55. 'queueID' : 'queue', //默认队列ID
56. 'queueSizeLimit': 20, //一个队列上传文件数限制
57. 'removeCompleted' : true, //完成时是否清除队列默认true
58. 'removeTimeout' : 3, //完成时清除队列显示秒数,默认3秒
59. 'requeueErrors' : false, //队列上传出错，是否继续回滚队列
60. 'successTimeout' : 5, //上传超时
61. 'uploadLimit' : 99, //允许上传的最多张数
62. 'swf' : 'uploadify.swf', //swfUpload
63. 'uploader': 'uploadify.php', //服务器端脚本
66. //修改formData数据
67. 'onUploadStart' : function(file) {
68. //$("#file_upload").uploadify("settings", "someOtherKey", 2);
69. },
70. //'onUploadStart' : function(file) { // $("#perpic").uploadify("settings","formData",{"albumid":$("#albumid").val()}); // },
71. //删除时触发
72. 'onCancel' : function(file) {
73. //alert('The file ' + file.name + '--' + file.size + ' was cancelled.');
74. },
75. //清除队列
76. 'onClearQueue' : function(queueItemCount) {
77. //alert(queueItemCount + ' file(s) were removed from the queue');
78. },
79. //调用destroy是触发
80. 'onDestroy' : function() {
81. alert('我被销毁了');
82. },
83. //每次初始化一个队列是触发
84. 'onInit' : function(instance){
85. //alert('The queue ID is ' + instance.settings.queueID);
86. },
87. //上传成功
88. 'onUploadSuccess' : function(file, data, response) {
89. //alert(file.name + ' | ' + response + ':' + data);
90. },
91. //上传错误
92. 'onUploadError' : function(file, errorCode, errorMsg, errorString) {
93. //alert('The file ' + file.name + ' could not be uploaded: ' + errorString);
94. },
95. //上传汇总
96. 'onUploadProgress' : function(file, bytesUploaded, bytesTotal, totalBytesUploaded, totalBytesTotal) {
97. $('#progress').html(totalBytesUploaded + ' bytes uploaded of ' + totalBytesTotal + ' bytes.');
98. },
99. //上传完成
100. 'onUploadComplete' : function(file) {
101. //alert('The file ' + file.name + ' finished processing.');
102. },
104. });
105. });
108. //变换按钮
109. function changeBtnText() {
110. $('#file_upload').uploadify('settings','buttonText','继续上传');
111. }
114. //返回按钮
115. function returnBtnText() {
116. alert('The button says ' + $('#file_upload').uploadify('settings','buttonText'));
117. }
118. </script>
119. <h4>操作:</h4>
120. <a href="javascript:$('#file_upload').uploadify('upload', '*');">开始上传</a> |
121. <a href="javascript:$('#file_upload').uploadify('cancel', '*');">清除队列</a> |
122. <a href="javascript:$('#file_upload').uploadify('destroy');">销毁上传</a> |
123. <a href="javascript:$('#file_upload').uploadify('disable', true);">禁用上传</a> |
124. <a href="javascript:$('#file_upload').uploadify('disable', false);">激活上传</a> |
125. <a href="javascript:$('#file_upload').uploadify('stop');">停止上传</a> |
126. <a href="changeBtnText();"< /span>>变换按钮</a> |
127. <h4>大小:</h4>
128. <div id='progress'></div>
129. </body>
130. </html>