jQuery上传插件Uploadify使用详解
Uploadify是JQuery的一个上传插件,实现的效果非常不错,带进度显示。不过官方提供的实例时php版本的,本文将详细介绍Uploadify在Aspnet中的使用,您也可以点击下面的链接进行演示或下载。
官方下载 官方文档 官方演示首先按下面的步骤来实现一个简单的上传功能。
1 创建Web项目,命名为JQueryUploadDemo,从官网上下载最新的版本解压后添加到项目中。
2 在项目中添加UploadHandler.ashx文件用来处理文件的上传。
3 在项目中添加UploadFile文件夹,用来存放上传的文件。
进行完上面三步后项目的基本结构如下图:
4 Default.aspx的html页的代码修改如下:
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文件”,打开文件选择框效果如下图:
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个属性。代码如下:
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/sonComplete:文件上传完成后触发。该函数有四个参数event、queueId、fileObj、response、data五个参数,前三个参数同上。response为后台处理程序返回的值,在上面的例子中为1或0,data有两个属性fileCount和speed
fileCount:剩余没有上传完成的文件的个数。 speed:文件上传的平均速率 kb/sonAllComplete:文件队列中所有的文件上传完成后触发。该函数有event和data两个参数,data有四个属性,分别为:
filesUploaded :上传的所有文件个数。 errors :出现错误的个数。 allBytesLoaded :所有上传文件的总大小。 speed :平均上传速率 kb/s相关函数介绍
在上面的例子中已经用了uploadifyUpload和uploadifyClearQueue两个函数,除此之外还有几个函数:
uploadifySettings:可以动态修改上面介绍的那些key值,如下面代码
简介
Uploadify简单说来,是基于Jquery的一款文件上传插件。它的功能特色总结如下:
相关链接
Uploadify主页地址:http://www.uploadify.com/ 在该页面你可以了解到关于他的更多内容。
Uploadify在线演示:在线Demo
Uploadify配置参数及接口文档:http://www.uploadify.com/documentation
Uploadify插件下载地址:http://www.uploadify.com/download
使用方法
$(document).ready(
function
() {
$(
"#file_upload"
).uploadify({
//开启调试
'debug'
:
false
,
//是否自动上传
'auto'
:
false
,
//超时时间
'successTimeout'
:99999,
//附带值
'formData'
:{
'userid'
:
'用户id'
,
'username'
:
'用户名'
,
'rnd'
:
'加密密文'
},
//flash
'swf'
:
"uploadify.swf"
,
//不执行默认的onSelect事件
'overrideEvents'
: [
'onDialogClose'
],
//文件选择后的容器ID
'queueID'
:
'uploadfileQueue'
,
//服务器端脚本使用的文件对象的名称 $_FILES个['upload']
'fileObjName'
:
'upload'
,
//上传处理程序
'uploader'
:
'imageUpload.php'
,
//浏览按钮的背景图片路径
'buttonImage'
:
'upbutton.gif'
,
//浏览按钮的宽度
'width'
:
'100'
,
//浏览按钮的高度
'height'
:
'32'
,
//expressInstall.swf文件的路径。
'expressInstall'
:
'expressInstall.swf'
,
//在浏览窗口底部的文件类型下拉菜单中显示的文本
'fileTypeDesc'
:
'支持的格式:'
,
//允许上传的文件后缀
'fileTypeExts'
:
'*.jpg;*.jpge;*.gif;*.png'
,
//上传文件的大小限制
'fileSizeLimit'
:
'3MB'
,
//上传数量
'queueSizeLimit'
: 25,
//每次更新上载的文件的进展
'onUploadProgress'
:
function
(file, bytesUploaded, bytesTotal, totalBytesUploaded, totalBytesTotal) {
//有时候上传进度什么想自己个性化控制,可以利用这个方法
//使用方法见官方说明
},
//选择上传文件后调用
'onSelect'
:
function
(file) {
},
//返回一个错误,选择文件的时候触发
'onSelectError'
:
function
(file, errorCode, errorMsg){
switch
(errorCode) {
case
-100:
alert(
"上传的文件数量已经超出系统限制的"
+$(
'#file_upload'
).uploadify(
'settings'
,
'queueSizeLimit'
)+
"个文件!"
);
break
;
case
-110:
alert(
"文件 ["
+file.name+
"] 大小超出系统限制的"
+$(
'#file_upload'
).uploadify(
'settings'
,
'fileSizeLimit'
)+
"大小!"
);
break
;
case
-120:
alert(
"文件 ["
+file.name+
"] 大小异常!"
);
break
;
case
-130:
alert(
"文件 ["
+file.name+
"] 类型不正确!"
);
break
;
}
},
//检测FLASH失败调用
'onFallback'
:
function
(){
alert(
"您未安装FLASH控件,无法上传图片!请安装FLASH控件后再试。"
);
},
//上传到服务器,服务器返回相应信息到data里
'onUploadSuccess'
:
function
(file, data, response){
alert(data);
}
});
});
大体上常用的我想也就这些,至于后端处理上传部分,我这里就不多讲了,和普通的文件上传处理方式是一样的。