uploadify 学习与实践 一网打尽

无论是做Web产品还是Web项目,文件上传是经常要用到的功能。以前经常听到做项目的同事抱怨:“这款文件上传控件功能强大但是用起来麻烦,最简单的input上传使用方便但是功能太简单(例如不支持多文件),外观也不尽如人意”。之后我一直留意网上的上传控件,最近看到一款基于jquery的上传插件Uploadify无论在功能、外观、可用性和扩展性上都有不错表现,于是研究了一番,介绍给大家。

Uploadify

简介

Uploadify简单说来,是基于Jquery的一款文件上传插件。它的功能特色总结如下:

  1. 支持单文件或多文件上传,可控制并发上传的文件数
  2. 在服务器端支持各种语言与之配合使用,诸如PHP,.NET,Java……
  3. 通过参数可配置上传文件类型及大小限制
  4. 通过参数可配置是否选择文件后自动上传
  5. 易于扩展,可控制每一步骤的回调函数(onSelect, onCancel……)
  6. 通过接口参数和CSS控制外观
  7. 更多……

相关链接

Uploadify主页地址:http://www.uploadify.com/ 在该页面你可以了解到关于他的更多内容。

Uploadify在线演示:在线Demo

Uploadify配置参数及接口文档:http://www.uploadify.com/documentation

Uploadify插件下载地址:http://www.uploadify.com/download

使用方法

  1. 下载插件安装包后,可以看到里面的几个主要文件:jquery.uploadify.js(完成上传功能的脚本文件,在调用页面引用)、uploadify.css(外观样式表)、uploader.swf(上传控件的主体文件,flash控件)、upload.php(服务器端处理文件,官方仅提供了php版的)
  2. 引用了插件文件后,在页面中做如下调用:
    //声明一个普通的html文件上传控件,并指定id
    <input type="file" name="fileInput" id="fileInput" />
    1.    
    2. //将声明的普通上传控件与Uploadify插件绑定  
    3. <span><</span>script type<span>=</span><span>"text/javascript"</span><span>></span>  
    4. $<span>(</span>document<span>)</span>.<span>ready</span><span>(</span><span>function</span><span>(</span><span>)</span> <span>{</span>  
    5. $<span>(</span><span>'#fileInput'</span><span>)</span>.<span>fileUpload</span> <span>(</span><span>{</span>  
    6. <span>//以下参数均是可选</span>  
    7. <span>'uploader'</span>  <span>:</span> <span>'uploader.swf'</span><span>,</span>   <span>//指定上传控件的主体文件,默认‘uploader.swf’</span>  
    8. <span>'script'</span>    <span>:</span> 'UploadHandler.ashx',//指定服务器端上传处理文件  
    1. <span>'cancelImg'</span> <span>:</span> <span>'cancel.png'</span><span>,</span>   <span>//指定取消上传的图片,默认‘cancel.png’</span>  
    1. <span>'auto'</span>      <span>:</span> <span>true</span><span>,</span>               <span>//选定文件后是否自动上传,默认false</span>  
    2. <span>'folder'</span>    <span>:</span> <span>'/uploads'</span>         <span>//要上传到的服务器路径,默认‘/’</span>  
    3. <span>'multi'</span>     <span>:</span> <span>true</span><span>,</span>               <span>//是否允许同时上传多文件,默认false</span>  
    4. <span>'fileDesc'</span> <span>:</span> <span>'rar文件或zip文件'</span>  <span>//出现在上传对话框中的文件类型描述</span>  
    5. <span>'fileExt'</span>   <span>:</span> <span>'*.rar;*.zip'</span><span>,</span>      <span>//控制可上传文件的扩展名,启用本项时需同时声明fileDesc</span>  
    6. <span>'sizeLimit'</span><span>:</span> <span>86400</span>           <span>//控制上传文件的大小,单位byte</span>  
    7. <span>'simUploadLimit'</span> <span>:</span><span>5</span>         <span>//多文件上传时,同时上传文件数目限制</span>  
    8. <span>}</span><span>)</span><span>;</span>  
    9. <span>}</span><span>)</span><span>;</span>  
    10. <span></</span>script<span>></span>  
    11.    
    12. 上面列出了我认为常用的配置选项,此外还有很多参数可配置,参考官方文档  
  3. 通过调用相关功能函数,声明功能按钮。
    例如声明上传功能按钮(自动上传时不需要):
    <a href="javascript:$('#fileInput').fileUploadStart();">上传文件</a>

    声明取消多文件上传时上传队列:

    <a href="javascript:$('#fileInput').fileUploadClearQueue();">取消上传队列</a>
    UploadHandler.ashx:
    
          
          
    1. using System;  
    2. using System.Collections.Generic;  
    3. using System.Linq;  
    4. using System.Web;  
    5. using System.Web.Services;  
    6. using System.IO;  
    7.   
    8. namespace JQuery.UploadFile  
    9. {  
    10.     /// <summary>  
    11.     /// $codebehindclassname$ 的摘要说明  
    12.     /// </summary>  
    13.     [WebService(Namespace = "http://tempuri.org/")]  
    14.     [WebServiceBinding(ConformsTo = WsiProfiles.BasicProfile1_1)]  
    15.     public class UploadHandler : IHttpHandler  
    16.     {  
    17.   
    18.         public void ProcessRequest(HttpContext context)  
    19.         {  
    20.             context.Response.ContentType = "text/plain";  
    21.             context.Response.Charset = "utf-8";  
    22.   
    23.             HttpPostedFile file = context.Request.Files["Filedata"];  
    24.             string uploadPath = HttpContext.Current.Server.MapPath(@context.Request["folder"]) + "\\";  
    25.   
    26.             if (file != null)  
    27.             {  
    28.                 if (!Directory.Exists(uploadPath))  
    29.                 {  
    30.                     Directory.CreateDirectory(uploadPath);  
    31.                 }  
    32.                 file.SaveAs(uploadPath + file.FileName);  
    33.                 //下面这句代码缺少的话,上传成功后上传队列的显示不会自动消失  
    34.                 context.Response.Write("1");  
    35.             }  
    36.             else  
    37.             {  
    38.                 context.Response.Write("0");  
    39.             }  
    40.         }  
    41.   
    42.         public bool IsReusable  
    43.         {  
    44.             get  
    45.             {  
    46.                 return false;  
    47.             }  
    48.         }  
    49.     }  
    50. }  

    上面简单地实现了一个上传的功能,依靠函数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文件”,打开文件选择框效果如下图:

    2010-01-05_220920

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

    2010-01-05_220626

    上面介绍的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
                );
    
            }
        });
    });  

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

    2010-01-05_225323

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

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值