uploadify插件可选参数的详细介绍

uploadify插件可选参数的详细介绍

  

以下是可选项的参数说明：（红色的属性代表常用的)

 

1

uploader

上传控件的主体文件，flash控件

   默认值='uploadify.swf'

2

script

 

相对路径的后端脚本，它将处理您上传的文件。

绝对路径前缀或'/'或'http'的路径

  默认值='uploadify.php'

3

checkScript

 

检查该文件是否已经选择驻留在服务器上。
没有默认值。 官方例子中'check.php'是提供核心文件

4

scriptData

 

可提供URL传递参数。用来传递get参数。例如：

 index.jsp?id=1&action=uploadify可以设置成：

'script':'index.jsp',

'scriptData':{'id':1,'action':'uploadify'},

注：要设置‘method’：‘GET’.

 

5

fileDataName

 

 您的文件在上传服务器脚本阵列的名称。
   默认值='Filedata'

6

method

 

 设置为发送到后端脚本的方法。要么'get'或post'。

   默认值'post'

7

scriptAccess

 

 ?

8

folder

 

您想将文件保存到的路径。考虑到安全问题，一般并不在客户端设定后供服务器得到所存的路径。我试了下。这个参数好像以get的方式传递的。设定post得不到这个值。

9

queueID

 

 文件队列ID。与div的id一致。参考上一篇例子的用法。

10

queueSizeLimit

 

限制在一次队列中的次数（可选定几个文件）。默认值= 999，而一次可传几个文件有simUploadLimit属性决定。

11

multi

 

是否允许同时上传多文件，可设定true或false。

 默认false。设定true时，选中的文件是当前项。

12

auto

 

选定文件后是否自动上传，可设定true或false。

  默认false

13

fileDesc

 

出现在上传对话框中的文件类型描述。与fileExt需同时使用

14

fileExt

 

支持的格式，启用本项时需同时声明fileDesc。

如：‘*.rar,*.doc

 

15

sizeLimit

 

控制上传文件的大小，单位byte

16

simUploadLimit

 

多文件上传时，同时上传文件数目限制。默认1

  一次可传几个文件。

17

buttonText

 

默认按钮的名字。默认BROWER

18

buttonImg

 

使用图片按钮，设定图片的路径即可。

19

hideButton

 

上传按钮的隐藏。true 或false。默认flase

20

rollover

 

 ？

21

width

 

 按钮图片的长度。默认 110

22

height

 

 按钮图片的高度。默认 30

23

wmode

 

 背景透明transparent 与不透明opaque设定。默认 不透明

 

24

cancelImg

 

 取消按钮。设定图片路径。默认cancel.png

 

 

25

onInit

 

函数， 初始化时的状态。

onInit: function() { 

$("#id").html("上传前");},

26

onComplete

 

函数：可传递五个参数

event: 事件对象

queueID:完成文件的唯一标识符。

fileObj: 

  • name – 文件名

  • filepath –上传路径

  • size – 文件大小

  • creationDate –文件创建时间

  • modificationDate–文件最近修改时间

  • type –文件的扩展名

response:服务器回调的数据

data: 

  • fileCount – The totalnumber of files left in the queue

  • speed – 平均上传速度 KB/s

如：

onComplete:function(event, queueID, fileObj) {

  alert("文件:"+fileObj.name +"上传失败");  }

 

27

onSelectOnce

 

函数：可传递二个参数

event: The eventobject.

data: An objectcontaining details about the select operation.

  • fileCount – The total number offiles in the queue

  • filesSelected – The number of filesselected in the select operation

  • filesReplaced – The number of filesthat were replaced in the queue

  • allBytesTotal – The total number ofbytes for all files in the queue

 

28

onCancel

 

函数：可传递四个参数

event: The eventobject.

queueID: The uniqueidentifier of the file that was cancelled.

fileObj: An objectcontaining details about the file that was selected.

   • name – The name ofthe file

   • size – The size inbytes of the file

   • creationDate – Thedate the file was created

   • modificationDate –The last date the file was modified

   • type – The fileextension beginning with a '.'

 

data: Details aboutthe file queue.

   • fileCount – Thetotal number of files left in the queue

   • allBytesTotal –The total number of bytes left for all files in the queue

 

29

onClearQueue

 

函数：可传递一个参数

event: The event object.

30

onQueueFull

 

函数：可传递二个参数

• event - The event object.

• queueSizeLimit - The maximum size of the queue.

 

31

onError

 

函数：可传递四个参数

 

event: The eventobject.

queueID: The uniqueidentifier of the file that was errored.

fileObj: An objectcontaining details about the file that was selected.

  • name – The name of the file

  • size – The size in bytes of thefile

  • creationDate – The date the file wascreated

  • modificationDate – The last date thefile was modified

  • type – The file extensionbeginning with a '.'

errorObj: An object containing details about the errorreturned.

  • type – Either 'HTTP','IO', or 'Security'

  • info – An error messagedescribing the type of error returned

 

32

onOpen

 

函数：可传递三个参数

event: The event object.

queueID: The unique identifier of the file thatwas opened.

fileObj: An object containing details about thefile that was selected.

  • name – The name of the file

  • size – The size in bytes of thefile

  • creationDate – Thedate the file was created

  • modificationDate – The last date thefile was modified

  • type – The file extension beginningwith a '.'

 

33

onProgress

 

 

函数：可传递四个参数

event: The event object.

queueID: The unique identifier of the file thatwas updated.

fileObj: An object containing details about thefile that was selected.

  • name – The name of the file

  • size – The size in bytes of thefile

  • creationDate – The date the file wascreated

  • modificationDate – The last date thefile was modified

  • type – The file extension beginningwith a '.'

 

data: An object containing details about theupload and queue.

  • percentage – The current percentagecompleted for the upload

  • bytesLoaded – The current amount ofbytes uploaded

  • allBytesLoaded – The current amountof bytes loaded for all files in the queue

  • speed – The current upload speed inKB/s

 

34

onSelect

 

 

event: The event object.

queueID: The unique identifier of the file thatwas selected.

fileObj: An object containing details about thefile that was selected.

  • name – The name of the file

  • size – The size in bytes of thefile

  • creationDate – The date the file wascreated

  • modificationDate – The last date thefile was modified

  • type – The file extension beginningwith a '.'

 

35

onAllComplete

 

 

函数：可传递二个参数

 

event: The event object.

data: An object containing details about theupload process.

  • filesUploaded – The total number offiles uploaded

  • errors – The total number of errorswhile uploading

  • allbytesLoaded – The total number ofbytes uploaded

  • speed – The average speed of alluploaded files

 

36

onCheck

 

函数：可传递五个参数

 

event: The event object.

checkScript: The path to the file checking script.

fileQueue: A file queue object consistingof  key/value pairs with the queue ID as the keyand the filename as the value.

folder: The path to the upload folder.

single: True if only one file is being uploadedfrom the queue.