Uploadify上传控件

时间  2019-11-26 标签 uploadify 上传 控件

Uploadify简单说来，是基于jQuery的一款文件上传插件。它的功能特点总结以下：javascript

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

 

如何使用Uploadify

一、下载Uploadify插件php

二、在网页中引入插件的文件css

<link href="JS/uploadify.css" rel="stylesheet" type="text/css" />
<script type="text/javascript" src="JS/jquery-1.3.2.min.js"></script>
<script type="text/javascript" src="JS/swfobject.js"></script>
<script type="text/javascript" src="JS/jquery.uploadify.v2.1.0.min.js"></script>

三、编写一些上传相关的HTML代码java

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

四、使用JavaScript库jquery调用Uploadify插件jquery

<script type="text/javascript">
$(document).ready(function(){
    $("#uploadify").uploadify({
        'uploader': 'JS/uploadify.swf',
        'script': 'UploadHandler.ashx',
        'cancelImg': 'JS/cancel.png',
        'folder': 'UploadFile',
        'queueID': 'fileQueue',
        'auto': false,
        'multi': true
    });
});  
</script>

运行后效果以下图json

Uploadify上传控件中文API文档

选择了两个文件后，点击上传，就能够看到UploadFile文件夹中会增长这两个文件。服务器

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

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文件”，打开文件选择框效果以下图：ide

920_thumb

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 ：选择文件到文件队列中后的每个文件上的关闭按钮图标，以下图：函数

220626_thumb

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

        }
    });
});

当选择一个文件后弹出的消息以下图：

2010-01-05_225323_thumb

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);
联系我们 沪ICP备2021010478号-7