Jquery uploadify上传插件使用详解


Posted in Javascript onJanuary 13, 2016

Uploadify是JQuery的一个上传插件,实现的效果非常不错,带进度显示。不过官方提供的实例时php版本的,本文将详细介绍Uploadify在Aspnet中的使用,您也可以点击下面的链接进行演示或下载。
首先按下面的步骤来实现一个简单的上传功能。

1 创建Web项目,命名为JQueryUploadDemo,从官网上下载最新的版本解压后添加到项目中。

2 在项目中添加UploadHandler.ashx文件用来处理文件的上传。

3 在项目中添加UploadFile文件夹,用来存放上传的文件。

进行完上面三步后项目的基本结构如下图:

Jquery uploadify上传插件使用详解

4 Default.aspx的html页的代码修改如下:

<html xmlns="http://www.w3.org/1999/xhtml">
<head runat="server">
 <title>Uploadify</title>
 <link href="JS/jquery.uploadify-v2.1.0/example/css/default.css"
  rel="stylesheet" type="text/css" />
 <link href="JS/jquery.uploadify-v2.1.0/uploadify.css"
  rel="stylesheet" type="text/css" />

 <script type="text/javascript"
  src="JS/jquery.uploadify-v2.1.0/jquery-1.3.2.min.js"></script>

 <script type="text/javascript"
  src="JS/jquery.uploadify-v2.1.0/swfobject.js"></script>

 <script type="text/javascript"
 src="JS/jquery.uploadify-v2.1.0/jquery.uploadify.v2.1.0.min.js"></script>

 <script type="text/javascript">
  $(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
   });
  }); 
 </script>

</head>
<body>
 <div id="fileQueue"></div>
 <input type="file" name="uploadify" id="uploadify" />
 <p>
  <a href="javascript:$('#uploadify').uploadifyUpload()">上传</a>| 
  <a href="javascript:$('#uploadify').uploadifyClearQueue()">取消上传</a>
 </p>
</body>
</html>

5  UploadHandler类的ProcessRequest方法代码如下:

public void ProcessRequest(HttpContext context)
{
 context.Response.ContentType = "text/plain"; 
 context.Response.Charset = "utf-8"; 

 HttpPostedFile file = context.Request.Files["Filedata"]; 
 string uploadPath = 
  HttpContext.Current.Server.MapPath(@context.Request["folder"])+"\\"; 

 if (file != null) 
 { 
  if (!Directory.Exists(uploadPath)) 
  { 
   Directory.CreateDirectory(uploadPath); 
  } 
  file.SaveAs(uploadPath + file.FileName); 
  //下面这句代码缺少的话,上传成功后上传队列的显示不会自动消失
  context.Response.Write("1"); 
 } 
 else 
 { 
  context.Response.Write("0"); 
 } 
}

6 运行后效果如下图:

Jquery uploadify上传插件使用详解

7 选择了两个文件后,点击上传,就可以看到UploadFile文件夹中会增加这两个文件。

上面简单地实现了一个上传的功能,依靠函数uploadify实现,uploadify函数的参数为json格式,可以对json对象的key值的修改来进行自定义的设置,如multi设置为true或false来控制是否可以进行多文件上传,下面就来介绍下这些key值的意思:

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文件”,打开文件选择框效果如下图:

Jquery uploadify上传插件使用详解

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 :选择文件到文件队列中后的每一个文件上的关闭按钮图标,如下图:

Jquery uploadify上传插件使用详解

上面介绍的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 + "\r\n" +
         "文件名:" + fileObj.name + "\r\n" +
         "文件大小:" + fileObj.size + "\r\n" +
         "创建时间:" + fileObj.creationDate + "\r\n" +
         "最后修改时间:" + fileObj.modificationDate + "\r\n" +
         "文件类型:" + fileObj.type
      );

    }
  });
});

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

Jquery uploadify上传插件使用详解

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

注:fileObj对象和上面讲到的有些不太一样,onComplete 的fileObj对象有个filePath属性可以取出上传文件的路径。

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

终于写完了,对JQuery这个上传插件也基本了解了,希望对大家有所帮助,不对之处还望大家指正。

Javascript 相关文章推荐
使用firebug进行调试javascript的示例
Dec 16 Javascript
Array栈方法和队列方法的特点说明
Jan 24 Javascript
js中的事件捕捉模型与冒泡模型实例分析
Jan 10 Javascript
jQuery的层级查找方式分析
Jun 16 Javascript
微信小程序网络请求的封装与填坑之路
Apr 01 Javascript
vue实现一个移动端屏蔽滑动的遮罩层实例
Jun 08 Javascript
Webpack打包css后z-index被重新计算的解决方法
Jun 18 Javascript
Vue从TodoList中学父子组件通信
Feb 05 Javascript
Vue实战教程之仿肯德基宅急送App
Jul 19 Javascript
如何用vue-cli3脚手架搭建一个基于ts的基础脚手架的方法
Dec 12 Javascript
javascript使用正则表达式实现注册登入校验
Sep 23 Javascript
js实现限定范围拖拽的示例
Oct 26 Javascript
JavaScript类型检测之typeof 和 instanceof 的缺陷与优化
Jan 13 #Javascript
jquery对复选框(checkbox)的操作汇总
Jan 13 #Javascript
分享javascript计算时间差的示例代码
Mar 19 #Javascript
学习JavaScript设计模式之代理模式
Jan 12 #Javascript
基于JavaScript实现TAB标签效果
Jan 12 #Javascript
JavaScript实现瀑布流布局
Jun 28 #Javascript
轻松实现JavaScript图片切换
Jan 12 #Javascript
You might like
Zend Studio for Eclipse的java.lang.NullPointerException错误的解决方法
2008/12/06 PHP
PHP 类商品秒杀计时实现代码
2010/05/05 PHP
按上下级层次关系输出内容的PHP代码
2010/07/17 PHP
浅析PHP中的字符串编码转换(自动识别原编码)
2013/07/02 PHP
php读取qqwry.dat ip地址定位文件的类实例代码
2016/11/15 PHP
PHP与SQL语句常用大全
2016/12/10 PHP
ThinkPHP框架表单验证操作方法
2017/07/19 PHP
PHP回调函数与匿名函数实例详解
2017/08/16 PHP
JavaScript 指导方针
2007/04/05 Javascript
Javascript/Jquery——简单定时器的多种实现方法
2013/07/03 Javascript
js获取某元素的class里面的css属性值代码
2014/01/16 Javascript
javascript使用prototype完成单继承
2014/12/24 Javascript
使用纯javascript实现放大镜效果
2015/03/18 Javascript
JavaScript中split() 使用方法汇总
2015/04/17 Javascript
jQuery实现类似老虎机滚动抽奖效果
2015/08/06 Javascript
JavaScript实现网页加载进度条代码超简单
2015/09/21 Javascript
canvas实现流星雨的背景效果
2017/01/13 Javascript
分析JS中this引发的bug
2017/12/12 Javascript
详解Vue 事件修饰符capture 的使用
2017/12/29 Javascript
Vue中render方法的使用详解
2018/01/26 Javascript
JavaScript解析机制与闭包原理实例详解
2019/03/08 Javascript
ES6的异步终极解决方案分享
2019/07/11 Javascript
微信小程序开发之map地图组件定位并手动修改位置偏差
2019/08/17 Javascript
Vue退出登录时清空缓存的实现
2019/11/12 Javascript
Swift 3.0在集合类数据结构上的一些新变化总结
2016/07/11 Python
详解Python自建logging模块
2018/01/29 Python
Python实现统计给定列表中指定数字出现次数的方法
2018/04/11 Python
对Python中画图时候的线类型详解
2019/07/07 Python
解决Python列表字符不区分大小写的问题
2019/12/19 Python
基于python 凸包问题的解决
2020/04/16 Python
Python 3.10 的首个 PEP 诞生,内置类型 zip() 迎来新特性(推荐)
2020/07/03 Python
python cookie反爬处理的实现
2020/11/01 Python
优秀的应届生自荐信
2014/05/23 职场文书
汉语专业毕业生自荐信
2014/07/06 职场文书
在redisCluster中模糊获取key方式
2021/07/09 Redis
HTML基础详解(上)
2021/10/16 HTML / CSS