jQuery文件上传控件 Uploadify 详解


Posted in Javascript onJune 20, 2016

基于jquery的文件上传控件,支持ajax无刷新上传,多个文件同时上传,上传进行进度显示,删除已上传文件。

要求使用jquery1.4或以上版本,flash player 9.0.24以上。

有两个版本,一个用flash,一个是html5。html5的需要付费~所以这里只说flash版本的用法。

官网:http://www.uploadify.com/

控件截图:

jQuery文件上传控件 Uploadify 详解

用法:

首先引用下面的文件

<link rel="stylesheet" type="text/css" href="uploadify.css">
<script type="text/javascript" src="http://code.jquery.com/jquery-1.7.2.min.js"></script>
<script type="text/javascript" src="jquery.uploadify-3.1.min.js"></script>

创建一个file input,或者其它任何带ID的元素,并对其初始化Uploadify(注意目录下要有uploadify.swf这个文件,和uploadify.php后台文件,路径按项目中的目录结构)

<input type="file" name="file_upload" id="file_upload" />
<script>
 $(function(){
  $('#file_upload').uploadify({
  
 'swf'  :'uploadify.swf',
  
  'uploader':'uploadify.php'
  
 // Put your options here
 
 });

 });
</script>

这样子就完成了一个最基础的上传组建。基本原理是改变你创建的file input生成一个DOM结构,创建一个DIV按钮,按钮样式修改在uploadify.css文件中的.uploadify-button,将swf文件定位在按钮上面,这样当你点击按钮时实际上点击的是swf

选项:

$('#file_upload').uploadify({
 auto:false, 
 //接受true or false两个值,当为true时选择文件后会自动上传;为false时只会把选择的文件增加进队列但不会上传,这时只能使用upload的方法触发上传。不设置auto时默认为true
 buttonClass: "some-class", 
 //设置上传按钮的class
 buttonCursor: 'hand',
 //设置鼠标移到按钮上的开状,接受两个值'hand'和'arrow'(手形和箭头)
 buttonImage: 'img/browse-btn.png', 
 //设置图片按钮的路径(当你的按钮是一张图片时)。如果使用默认的样式,你还可以创建一个鼠标悬停状态,但要把两种状态的图片放在一起,并且默认的放上面,悬停状态的放在下面(原文好难表达啊:you can create a hover state for the button by stacking the off state above the hover state in the image)。这只是一个比较便利的选项,最好的方法还是把图片写在CSS里面。
 buttonText: '<div>选择文件</div>',
 //设置按钮文字。值会被当作html渲染,所以也可以包含html标签
 checkExisting: '/uploadify/check-exists.php',
 //接受一个文件路径。此文件检查正要上传的文件名是否已经存在目标目录中。存在时返回1,不存在时返回0(应该主要是作为后台的判断吧),默认为false
 debug: false,
 //开启或关闭debug模式
 fileObjName:'filedata',
 //设置在后台脚本使用的文件名。举个例子,在php中,如果这个选项设置为'the_files',你可以使用$_FILES['the_files']存取这个已经上传的文件。
 fileSizeLimit:'100MB',
 //设置上传文件的容量最大值。这个值可以是一个数字或者字符串。如果是字符串,接受一个单位(B,KB,MB,GB)。如果是数字则默认单位为KB。设置为0时表示不限制
 fileTypeExts: '*.*',
 //设置允许上传的文件扩展名(也就是文件类型)。但手动键入文件名可以绕过这种级别的安全检查,所以你应该始终在服务端中检查文件类型。输入多个扩展名时用分号隔开('*.jpg;*.png;*.gif')
 fileTypeDesc: 'All Files',
 //可选文件的描述。这个值出现在文件浏览窗口中的文件类型下拉选项中。(chrome下不支持,会显示为'自定义文件',ie and firefox下可显示描述)
 formData: {
  timestamp: '<?php echo $timestamp;?>',
  token: '<?php echo md5('unique_salt' . $timestamp);?>'
 },
 //通过get或post上传文件时,此对象提供额外的数据。如果想动态设置这些值,必须在onUploadStartg事件中使用settings的方法设置。在后台脚本中使用 $_GET or $_POST arrays (PHP)存取这些值。看官网参考写法:http://www.uploadify.com/documentation/uploadify/formdata/
 height: 30,
 //设置按钮的高度(单位px),默认为30.(不要在值里写上单位,并且要求一个整数,width也一样)
 width: 120,
 //设置按钮宽度(单位px),默认120
 itemTemplate:false,
 //模板对象。给增加到上传队列中的每一项指定特殊的html模板。模板格式请看官网http://www.uploadify.com/documentation/uploadify/itemtemplate/
 method:'post',
 //提交上传文件的方法,接受post或get两个值,默认为post
 multi: false,
 //设置是否允许一次选择多个文件,true为允许,false不允许
 overrideEvents: [],
 //重写事件,接受事件名称的数组作为参数。所设置的事件将可以被用户重写覆盖
 preventCaching:true,
 //是否缓存swf文件。默认为true,会给swf的url地址设置一个随机数,这样它就不会被缓存。(有些浏览器缓存了swf文件就会触发不了里面的事件--by rainweb)
 progressData: 'percentage',
 //设置文件上传时显示数据,有‘percentage' or ‘speed'两个参数(百分比和速度)
 queueID: false,
 //设置上传队列DOM元素的ID,上传的项目会增加进这个ID的DOM中。设置为false时则会自动生成队列DOM和ID。默认为false
 queueSizeLimit: 999,
 //设置每一次上传队列中的文件数量。注意并不是限制总的上传文件数量(那是uploadLimit).如果增加进队列中的文件数量超出这个值,将会触发onSelectError事件。默认值为999
 removeCompleted: true,
 //是否移除掉队列中已经完成上传的文件。false为不移除
 removeTimeout: 3,
 //设置上传完成后删除掉文件的延迟时间,默认为3秒。如果removeCompleted为false的话,就没意义了
 requeueErrors: false,
 //设置上传过程中因为出错导致上传失败的文件是否重新加入队列中上传
 successTimeout: 30,
 //设置文件上传后等待服务器响应的秒数,超出这个时间,将会被认为上传成功,默认为30秒
 swf: 'uploadify.swf',
 //swf的相对路径,必写项
 uploader: 'uploadify.php'
 //服务器端脚本文件路径,必写项
 uploadLimit: 999
 //上传文件的数量。达到或超出这数量会触发onUploadError方法。默认999
})

事件:

$('#file_upload').uploadify({ 
 onCancel: function(file){
   console.log('The file'+ file.name + 'was cancelled.')
 },
 //文件被移除出队列时触发,返回file参数
 onClearQueue: function(queueItemCount){
  console.log(queueItemCount+'file(s) were removed frome the queue')
 },
 //当调用cancel方法且传入'*'这个参数的时候触发,其实就是移除掉整个队列里的文件时触发,上面有说cancel方法带*时取消整个上传队列
 onDestroy: function(){
  //调用destroy方法的时候触发
 },
 onDialogClose: function(queueData){
  console.log(queueData.filesSelected+'\n'+queueData.filesQueued+'\r\n'+queueData.filesReplaced+'\r\n'+queueData.filesCancelled+'\r\n'+ queueData.filesErrored)
 },
 //关闭掉浏览文件对话框时触发。返回queueDate参数,有以下属性:
 /*
  filesSelected 浏览文件对话框中选取的文件数量
  filesQueued 加入上传队列的文件数
  filesReplaced 被替换的文件个数
  filesCancelled 取消掉即将加入队列中的文件个数
  filesErrored 返回错误的文件个数
 */
 onDialogOpen:function(){
  //打开选择文件对话框时触发
 },
 onDisable:function(){
  //禁用uploadify时触发(通过disable方法)
 },
 onEnalbe: function(){
  //启用uploadify时触发(通过disable方法)
 },
 onFallback:function(){
  //在初始化时检测不到浏览器有兼容性的flash版本时实触发
 },
 onInit: function(instance){
  console.log('The queue ID is'+ instance.settings.queueID)
 },
 //每次初始化一个队列时触发,返回uploadify对象的实例
 onQueueComplete:function(queueData){
  console.log(queueData.uploadsSuccessful+'\n'+queueData.uploadsErrored)
 },
 //队列中的文件都上传完后触发,返回queueDate参数,有以下属性:
 /*
  uploadsSuccessful 成功上传的文件数量
  uploadsErrored 出现错误的文件数量
 */
 onSelect: function(file){
  console.log(file.name)
 },
 //选择每个文件增加进队列时触发,返回file参数
 onSelectError: function(file,errorCode,errorMsg){
  console.log(errorCode)
  console.log(this.queueData.errorMsg)
 },
 //选择文件出错时触发,返回file,erroCode,errorMsg三个参数
 /*
  errorCode是一个包含了错误码的js对象,用来查看事件中发送的错误码,以确定错误的具体类型,可能会有以下的常量:
  QUEUE_LIMIT_EXCEEDED:-100 选择的文件数量超过设定的最大值;
  FILE_EXCEEDS_SIZE_LIMIT:-110 文件的大小超出设定
  INVALID_FILETYPE:-130 选择的文件类型跟设置的不匹配

  errorMsg 完整的错误信息,如果你不重写默认的事件处理器,可以使用‘this.queueData.errorMsg' 存取完整的错误信息
 */
 onSWFReady: function(){
  //swf动画加载完后触发,没有参数
 },
 onUploadComplete: function(file){
  //在每一个文件上传成功或失败之后触发,返回上传的文件对象或返回一个错误,如果你想知道上传是否成功,最后使用onUploadSuccess或onUploadError事件
 },
 onUploadError: function(file,errorCode,erorMsg,errorString){
 },
 //一个文件完成上传但返回错误时触发,有以下参数
 /*
  file 完成上传的文件对象
  errorCode 返回的错误代码
  erorMsg 返回的错误信息
  errorString 包含所有错误细节的可读信息
 */
 onUploadProgress: function(file,bytesUploaded,bytesTotal,totalBytesUploaded,totalBytesTotal){
  $('#pregress').html('总共需要上传'+bytesTotal+'字节,'+'已上传'+totalBytesTotal+'字节')
 },
 //每更新一个文件上传进度的时候触发,返回以下参数
 /*
  file 正上传文件对象
  bytesUploaded 文件已经上传的字节数
  bytesTotal 文件的总字节数
  totalBytesUploaded 在当前上传的操作中(所有文件)已上传的总字节数
  totalBytesTotal 所有文件的总上传字节数
 */
 onUploadStart: function(file){
  console.log('start update')
 },
 //每个文件即将上传前触发
 onUploadSuccess: function(file,data,respone){
  alert( 'id: ' + file.id
    + ' - 索引: ' + file.index




+ ' - 文件名: ' + file.name





+ ' - 文件大小: ' + file.size





+ ' - 类型: ' + file.type





+ ' - 创建日期: ' + file.creationdate





+ ' - 修改日期: ' + file.modificationdate





+ ' - 文件状态: ' + file.filestatus





+ ' - 服务器端消息: ' + data





+ ' - 是否上传成功: ' + response);
 }
 //每个文件上传成功后触发    
})

方法:

Uploadify使用jquery推荐的插件模式,这意味着所有方法的调用都保持在一个命名空间里。 调用这些不同的方法,只需要把方法当成第一个参数传进uploadify里调用就行。在这些方法后面增加参数会被传进这个方法里(这两句翻译得不是很顺畅,附原文: To use the different method calls, simply call Uploadify on the DOM element with the method call as the first argument.Any additional arguments added after the method name are passed to the method.)

cancel:取消第一个上传的文件,如果后面带参数"*"则是取消掉整个上传队列,如$(el).uploadify('cancel', '*')

upload:上传第一个上传的文件,如果后面带参数"*"则上传整个队列,跟cancel一样

destroy:移除掉上传组建,按html默认的方法上传

disable:有true or false 两个参数,表示是否禁止上传按钮,true表示禁止,false表示允许上传

settings:返回或者更新一个实例的方法值,接受一个方法名的参数时是返回那个方法的值,当后面再跟一个参数,则是更新那个方法的值。如

$(el).uploadify('settings','buttonText','BROWSE'); //设置buttonText的值为BROWSE
$(el).uploadify('settings','buttonText') //返回buttonText的值

stop:停止正在上传中的文件或队列

以上就是本文的全部内容,希望能给大家一个参考,也希望大家多多支持三水点靠木。

Javascript 相关文章推荐
基于jQuery的树控件实现代码(asp.net+json)
Jul 11 Javascript
基于Jquery与WebMethod投票功能实现代码
Jan 19 Javascript
javascript之querySelector和querySelectorAll使用介绍
Dec 20 Javascript
Javascript Boolean、Nnumber、String 强制类型转换的区别详细介绍
Dec 13 Javascript
鼠标经过显示二级菜单js特效
Aug 13 Javascript
网站繁简切换的JS遇到页面卡死的解决方法
Mar 12 Javascript
轻松实现jquery选项卡切换效果
Oct 10 Javascript
JS正则表达式修饰符global(/g)用法分析
Dec 27 Javascript
Three.js利用顶点绘制立方体的方法详解
Sep 27 Javascript
JS基于对象的特性实现去除数组中重复项功能详解
Nov 17 Javascript
JavaScript实现京东购物放大镜和选项卡效果的方法分析
Jul 05 Javascript
layui实现数据分页功能(ajax异步)
Jul 27 Javascript
javascript js 操作数组 增删改查的简单实现
Jun 20 #Javascript
浅谈JavaScript中数组的增删改查
Jun 20 #Javascript
【经验总结】编写JavaScript代码时应遵循的14条规律
Jun 20 #Javascript
jQuery Tags Input Plugin(添加/删除标签插件)详解
Jun 20 #Javascript
javascript实现随机生成DIV背景色
Jun 20 #Javascript
使用jQuery Rotare实现微信大转盘抽奖功能
Jun 20 #Javascript
JS实现弹出居中的模式窗口示例
Jun 20 #Javascript
You might like
php disk_free_space 返回目录可用空间
2010/05/10 PHP
基于PHP导出Excel的小经验 完美解决乱码问题
2013/06/10 PHP
PHP下载大文件失败并限制下载速度的实例代码
2019/05/10 PHP
laravel-admin表单提交隐藏一些数据,回调时获取数据的方法
2019/10/08 PHP
jQuery阻止冒泡和HTML默认操作
2010/11/17 Javascript
基于jQuery的输入框无值自动显示指定数据的实现代码
2011/01/24 Javascript
Javascript合并表格中具有相同内容单元格示例
2013/08/11 Javascript
jquery自定义滚动条插件示例分享
2014/02/21 Javascript
Javascript中数组sort和reverse用法分析
2014/12/30 Javascript
快速移动鼠标触发问题及解决方法(ECharts外部调用保存为图片操作及工作流接线mouseenter和mouseleave)
2016/08/29 Javascript
jQuery 局部div刷新和全局刷新方法总结
2016/10/05 Javascript
Bootstrap企业网站实战项目4
2016/10/14 Javascript
3种不同的ContextMenu右键菜单实现代码
2016/11/03 Javascript
详解js中Number()、parseInt()和parseFloat()的区别
2016/12/20 Javascript
浅析node.js的模块加载机制
2018/05/25 Javascript
浅谈微信页面入口文件被缓存解决方案
2018/09/29 Javascript
vue 解决computed修改data数据的问题
2019/11/06 Javascript
vue 实现把路由单独分离出来
2020/08/13 Javascript
Python常用正则表达式符号浅析
2014/08/13 Python
浅谈Python NLP入门教程
2017/12/25 Python
Diango + uwsgi + nginx项目部署的全过程(可外网访问)
2018/04/22 Python
python中import与from方法总结(推荐)
2019/03/21 Python
python实现nao机器人手臂动作控制
2019/04/29 Python
python中将两组数据放在一起按照某一固定顺序shuffle的实例
2019/07/15 Python
Kmeans均值聚类算法原理以及Python如何实现
2020/09/26 Python
亚历山大·王官网:Alexander Wang
2017/06/23 全球购物
软件项目经理岗位职责
2015/04/01 职场文书
毕业论文致谢部分怎么写
2015/05/14 职场文书
英语导游欢迎词
2015/09/30 职场文书
奖学金申请书(范文)
2019/08/14 职场文书
创业计划书之韩国烧烤店
2019/09/19 职场文书
编写python程序的90条建议
2021/04/14 Python
教你用Java Swing实现自助取款机系统
2021/06/11 Java/Android
java高级用法JNA强大的Memory和Pointer
2022/04/19 Java/Android
MySQL如何使备份得数据保持一致
2022/05/02 MySQL
Django数据库(SQlite)基本入门使用教程
2022/07/07 Python