首页 > 代码库 > jquery的uploadify插件多文件上传配置参数详解

jquery的uploadify插件多文件上传配置参数详解

最近做了个多文件上传,需要限制上传文件类型的例子。以前没做过找了一些资料,下次有用。同时也给大家做参考。

uploader: uploadify.swf 文件的相对路径,该swf文件是一个带有文字BROWSE的按钮,点击后淡出打开文件对话框,默认值:uploadify.swf。

   script:   后台处理程序的相对路径 。默认值:uploadify.php

  checkScript:用来判断上传选择的文 件在服务器是否存在的后台处理程序的相对路径

  fileDataName:设置一个名字,在服务器处理程序中根据该名字来取上传文件的 数据。默认为Filedata

  method: 提交方式Post 或Get 默认为Post

   scriptAccess :flash脚本文件的访问模式,如果在本地测试设置为always,默认值:sameDomain 

   folder :上传文件存放的目录 。

  queueID :文件队列的ID,该ID与存放文件队列的div的ID一致。

   queueSizeLimit :当允许多文件生成时,设置选择文件的个数,默认值:999 。

  multi :设置为true时可以上传多个文件。

  auto :设置为true当选择文件后就直接上传了,为false需要点击上传按钮才上传 。

  fileDesc :这个属性值必须设置fileExt属性后才有效,用来设置选择文件对话框中的提示文本,如设置fileDesc为“请选择rar doc pdf文件”,打开文件选择框效果如下图:

  fileExt :设置可以选择的文件的类型,格式如:‘*.doc;*.pdf;*.rar‘ 。

  sizeLimit :上传文件的大小限制 。

  simUploadLimit :允许同时上传的个数 默认值:1 。

  buttonText :浏览按钮的文本,默认值:BROWSE 。

  buttonImg :浏览按钮的图片的路径 。

   hideButton :设置为true则隐藏浏览按钮的图片 。

  rollover :值为true和false,设置为true时当鼠标移到浏览按钮上时有反转效果。

  width :设置浏览按钮的宽度 ,默认值:110。

  height :设置浏览按钮的高度 ,默认值:30。

  wmode :设置该项为transparent 可以使浏览按钮的flash背景文件透明,并且flash文件会被置为页面的最高层。 默认值:opaque 。

   cancelImg:选择文件到文件队列中后的每一个文件上的关闭按钮图标,如下图:

  上面介绍的key 值的value都为字符串或是布尔类型,比较简单,接下来要介绍的key值的value为一个函数,可以在选择文件、出错或其他一些操作的时候返回一些信 息给用户。

  onInit :做一些初始化的工作。

  onSelect:选择文件时触发,该函数有三个参数

   event:事件对象。

  queueID:文件的唯一标识,由6为随机字符组成。

  fileObj:选择的文件对 象,有name、size、creationDate、modificationDate、type 5个属性。

  代码如下:

$(document).ready(function()  
{ 
$("#uploadify").uploadify({ 
‘uploader‘:  ‘JS/jquery.uploadify-v2.1.0/uploadify.swf‘, 
‘script‘:  ‘UploadHandler.ashx‘, 
‘cancelImg‘:  ‘JS/jquery.uploadify-v2.1.0/cancel.png‘, 
‘folder‘: ‘UploadFile‘,  
‘queueID‘: ‘fileQueue‘, 
‘auto‘: false, 
‘multi‘:  true, 
‘onInit‘:function(){alert("1");}, 
‘onSelect‘:  function(e, queueId, fileObj) 
{ 
alert("唯一标识:" +  queueId + " " + 
"文件名:" + fileObj.name + " " + 
"文件大小:" + fileObj.size + " " + 
"创建时间:" +  fileObj.creationDate + " " + 
"最后修改时间:" +  fileObj.modificationDate + " " + 
"文件类型:" + fileObj.type 
); 

} 
}); 
}); 

 

当 选择一个文件后弹出的消息如下图:

   onSelectOnce:在单文件或多文件上传时,选择文件时触发。该函数有两个参数event,data,data对象有以下几个属性:

   fileCount:选择文件的总数。

  filesSelected:同时选择文件的个数,如果一次选择了3个文件该属性值为3。

   filesReplaced:如果文件队列中已经存在A和B两个文件,再次选择文件时又选择了A和B,该属性值为2。

   allBytesTotal:所有选择的文件的总大小。

  onCancel :当点击文件队列中文件的关闭按钮或点击取消上传时触发。该函数有event、queueId、fileObj、data四个参数,前三个参数同

   onSelect中的三个参数,data对象有两个属性fileCount和allBytesTotal。

  fileCount:取消 一个文件后,文件队列中剩余文件的个数。

  allBytesTotal:取消一个文件后,文件队列中剩余文件的大小。

   onClearQueue:当调用函数fileUploadClearQueue时触发。有event和data两个参数,同onCancel 中的两个对应参数。

  onQueueFull :当设置了queueSizeLimit并且选择的文件个数超出了queueSizeLimit的值时触发。该函数有两个参数event和 queueSizeLimit。

  onError :当上传过程中发生错误时触发。该函数有event、queueId、fileObj、errorObj四个参数,其中前三个参数同上,errorObj 对象有type和info两个属性。

  type:错误的类型,有三种‘HTTP’, ‘IO’, or ‘Security’

   info:错误的描述

 onOpen :点击上传时触发,如果auto设置为true则是选择文件时触发,如果有多个文件上传则遍历整个文件队列。该函数有event、queueId、 fileObj三个参数,参数的解释同上。

  onProgress:点击上传时触发,如果auto设置为true则是选择文件时触发,如 果有多个文件上传则遍历整个文件队列,在onOpen之后触发。该函数有 event、queueId、fileObj、data四个参数,前三个参数的解释同上。data对象有四个属性percentage、 bytesLoaded、allBytesLoaded、speed:

  percentage:当前完成的百分比

   bytesLoaded:当前上传的大小

  allBytesLoaded:文件队列中已经上传完的大小

   speed:上传速率 kb/s

  onComplete:文件上传完成后触发。该函数有四个参数event、queueId、 fileObj、response、data五个参数,前三个参数同上。response为后台处理程序返回的值,在上面的例子中为1或0,data有两 个属性fileCount和speed

  fileCount:剩余没有上传完成的文件的个数。

  speed:文件上传 的平均速率 kb/s

  onAllComplete:文件队列中所有的文件上传完成后触发。该函数有event和data两个参 数,data有四个属性,分别为:

  filesUploaded :上传的所有文件个数。

  errors :出现错误的个数。

  allBytesLoaded :所有上传文件的总大小。

  speed :平均上传速率 kb/s

  相关函数介绍

  在上面的例子中已经用了uploadifyUpload和 uploadifyClearQueue两个函数,除此之外还有几个函数:

  uploadifySettings:可以动态修改上面介绍 的那些key值,如下面代码

  $(‘#uploadify‘).uploadifySettings(‘folder‘,‘JS‘);

   如果上传按钮的事件写成下面这样,文件将会上传到uploadifySettings定义的目录中

<a  href="javascript:$(‘#uploadify‘).uploadifySettings(‘folder‘,‘JS‘);

$(‘#uploadify‘).uploadifyUpload()"> 上传</a>

  uploadifyCancel:该函数接受一个queueID作为参数,可以取消文件队列中 指定queueID的文件。

  $(‘#uploadify‘).uploadifyCancel(id);

 

原文转自:http://hi.baidu.com/whlxjq520/item/7aed756f9b915c0fa1cf0f40