webuploader.js

PHP  多图上传，图片批量上传插件，webuploader.js，百度文件上传插件（案例教程）

WebUploader作用：

使用WebUploader还可以批量上传文件、支持缩略图等等众多参数选项可设置，以及多个事件方法可调用，你可以随心所欲的定制你要的上传组件。

使用：

1、导入Css样式文件：

1 2	<link rel="stylesheet" type="text/css" href="css/webuploader.css"> <link rel="stylesheet" type="text/css" href="css/webstyle.css">

2、定义html：

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18

<div class="demo">     <h3 style="border-bottom: 1px solid #dadada;">多图上传</h3>     <div id="uploader">         <div class="queueList" style="min-height:150px;">                       </div>         <div class="statusBar" style="display:block; border-top: 1px solid #dadada;">             <div class="progress">                 <span class="text">0%</span>                 <span class="percentage"></span>             </div><div class="info"></div>             <div id="dndArea" class="btns">                  <div id="filePick" style="float:left;">选择图片</div>                 <div class="uploadBtn">开始上传</div>             </div>         </div>     </div> </div>

1、准备一个按钮#filePicker

2、准备一个用来存放添加的文件信息列表的容器.queueList

3、准备一个上传按钮.uploadBtn

2、javascript部分：

首先创建Web Uploader实例：

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77

// 实例化 uploader = WebUploader.create({     /*************** 重要参数 *************/     //是否自动上传（true是，false否）     auto: false,                                     //flash文件地址     swf: './Uploader.swf',                           //上传访问的地址     server: './upload.php',                          //每次请求附带的参数     formData: {act: 'ad_image'},                     //定义选择文件的按钮     pick: {id:'#filePick', label:'添加图片'},        /*************** 其他参数 ***************/     // 指定托动区     dnd: '#dndArea',        // 禁掉全局的拖拽功能。这样不会出现图片拖进页面的时候，把图片打开。           disableGlobalDnd: false,      // 指定监听paste事件的容器，如果不指定，不启用此功能。此功能为通过粘贴来添加截屏的图片      paste: '#uploader',      // 指定可以上传那些类型的图片          accept: {                         title: 'Images',         extensions: 'jpg,jpeg,png',         mimeTypes: 'image/jpg,image/jpeg,image/png'     },     thumb:{         width: 110,         height: 110,         // 图片质量，只有type为`image/jpeg`的时候才有效。         quality: 70,         // 是否允许放大，如果想要生成小图的时候不失真，此选项应该设置为false.         allowMagnify: false,         // 是否允许裁剪。         crop: true,         // 为空的话则保留原有图片格式。         // 否则强制转换成指定的类型。         type: 'image/jpeg'     },     compress:{         width: 1600,         height: 1600,         // 图片质量，只有type为`image/jpeg`的时候才有效。         quality: 90,         // 是否允许放大，如果想要生成小图的时候不失真，此选项应该设置为false.         allowMagnify: false,         // 是否允许裁剪。         crop: false,         // 是否保留头部meta信息。         preserveHeaders: true,         // 如果发现压缩后文件大小比原来还大，则使用原来图片         // 此属性可能会影响图片自动纠正功能         noCompressIfLarger: false,         // 单位字节，如果图片大小小于此值，不会采用压缩。         compressSize: 0,         // 强制转换成指定的类型。         type: 'image/jpeg'     },     //允许在文件传输时提前把下一个文件准备好 【默认值：false】     prepareNextFile:true,       //是否要分片处理大文件上传【默认值：false】     // chunked: false,             //分多大一片【默认值：5242880】     // chunkSize: 512 * 1024,      //如果某个分片由于网络问题出错，允许自动重传多少次!【默认值：2】     // chunkRetry:10,      //上传并发数。允许同时最大上传进程数【默认值：3】     // threads:3,          //文件上传方式，POST或者GET【默认值：'POST'】     // method:'POST',      //最大上传数量，（验证文件总数量, 超出则不允许加入队列）。     fileNumLimit: 20,      // 验证文件总大小是否超出限制, 超出则不允许加入队列     fileSizeLimit: 200 * 1024 * 1024,      // 验证单个文件大小是否超出限制, 超出则不允许加入队列     fileSingleSizeLimit: 50 * 1024 * 1024     });

接着监听fileQueued事件，即当有文件添加进来的时候，通过uploader.makeThumb来创建图片预览图

至于事件中用到的方法就不写出来的，需要研究的可以下载源码查看学习！（uploader.makeThumb也是写在方法里面去了）

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38

// 当文件被加入队列以后触发。 uploader.onFileQueued = function (file) {     fileCount++;     fileSize += file.size;       if (fileCount === 1) {         $placeHolder.addClass('element-invisible');         $statusBar.show();     }       addFile(file);     setState('ready');     updateTotalProgress(); };   // 上传过程中.... uploader.onUploadProgress = function (file, percentage) {     var $li = $('#' + file.id),             $percent = $li.find('.progress span');       $percent.css('width', percentage * 100 + '%');     percentages[ file.id ][ 1 ] = percentage;     updateTotalProgress(); };   // 当文件被移除队列后触发。 uploader.onFileDequeued = function (file) {     fileCount--;     fileSize -= file.size;       if (!fileCount) {         setState('pedding');     }       removeFile(file);     updateTotalProgress();   };

最后是上传状态提示了，

当文件上传过程中, 上传成功，上传失败，上传完成都分别对应

uploadProgress, uploadSuccess, uploadError, uploadComplete事件。

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25

// 文件上传成功 uploader.on( 'uploadSuccess', function( file,data ) {      var $li = $('#' + file.id),             $percent = $li.find('.success');         $dsf = $('<input type="hidden" name="images[]" value="'+data.file+'">').appendTo($li),     setState('confirm');   }); // 文件上传过程中创建进度条实时显示。 uploader.on( 'uploadProgress', function( file, percentage ) {     setState('uploading'); }); // 文件上传失败，显示上传出错 uploader.on( 'uploadError', function( file ) {     setState('finish'); });   uploader.on("uploadAccept", function( file, data){       if ( data.success==true) {           // 通过return false来告诉组件，此文件上传有错。           return true;       }else{         return false;       } });

至于事件中用到的方法就不写出来的，需要研究的可以下载源码查看学习！

 

2、PHP部分：

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17

<?php date_default_timezone_set("Asia/Shanghai"); //   1、图片文件上传处理     （上传逻辑就自己写了。）       //   2、返回值 // 假如这是上传成功后得到的文件名 $file = date("Ymd_").rand(1000,9999).'.jpg';   $res = array(         'success' => true,         'file'    => $file     ); die(json_encode($res));     ?>

 

 

常用选项设置与事件调用

Web Uploader项目的官网地址：http://fex.baidu.com/webuploader/

参数	描述	默认值
dnd	[可选] 指定Drag And Drop拖拽的容器，如果不指定，则不启动。	undefined
disableGlobalDnd	[可选] 指定监听paste事件的容器，如果不指定，不启用此功能。此功能为通过粘贴来添加截屏的图片。建议设置为document.body.	undefined
pick	[可选], Object,指定选择文件的按钮容器，不指定则不创建按钮。            id {Seletor|dom} 指定选择文件的按钮容器，不指定则不创建按钮。注意 这里虽然写的是 id, 但是不是只支持 id, 还支持 class, 或者 dom 节点。 label {String} 请采用 innerHTML 代替 innerHTML {String} 指定按钮文字。不指定时优先从指定的容器中看是否自带文字。 multiple {Boolean} 是否开起同时选择多个文件能力。	undefined
accept	[可选] 指定可接受的文件类型。 title {String} 文字描述 extensions {String} 允许的文件后缀，不带点，多个用逗号分割。 mimeTypes {String} 多个用逗号分割。	null
thumb	{Object} [可选] 配置生成缩略图的选项。
compress	{Object} [可选] 配置压缩的图片的选项。如果此选项为false, 则图片在上传前不进行压缩。
auto	[可选] 设置为 true 后，不需要手动调用上传，有文件选择即开始上传。	false
runtimeOrder	[可选] 指定运行时启动顺序。默认会想尝试 html5 是否支持，如果支持则使用 html5, 否则则使用 flash. 可以将此值设置成 flash，来强制使用 flash 运行时。	html5,flash
chunked	[可选] 是否要分片处理大文件上传。	false
chunkSize	[可选] 如果要分片，分多大一片？ 默认大小为5M.	5242880
chunkRetry	[可选]如果某个分片由于网络问题出错，允许自动重传次数。	2
threads	[可选] 上传并发数。允许同时最大上传进程数。	3
formData	[可选]文件上传请求的参数表，每次发送都会发送此对象中的参数。	{}
fileVal	[可选] 设置文件上传域的name。	file
fileNumLimit	[可选] 验证文件总数量, 超出则不允许加入队列。	undefined
fileSizeLimit	[可选] 验证文件总大小是否超出限制, 超出则不允许加入队列。	undefined
fileSingleSizeLimit	[可选] 验证单个文件大小是否超出限制, 超出则不允许加入队列。	undefined
duplicate	[可选] 去重， 根据文件名字、文件大小和最后修改时间来生成hash Key.	undefined

常用的事件说明：

事件	参数说明	描述
beforeFileQueued	file {File}File对象	当文件被加入队列之前触发，此事件的handler返回值为false，则此文件不会被添加进入队列。
fileQueued	file {File}File对象	当文件被加入队列以后触发。
filesQueued	file {File}数组，内容为原始File(lib/File）对象。	当一批文件添加进队列以后触发。
fileDequeued	file {File}File对象	当文件被移除队列后触发。
uploadStart	file {File}File对象	某个文件开始上传前触发，一个文件只会触发一次。
uploadBeforeSend	object {Object} data {Object}默认的上传参数，可以扩展此对象来控制上传参数。 headers {Object}可以扩展此对象来控制上传头部。	当某个文件的分块在发送前触发，主要用来询问是否要添加附带参数，大文件在开起分片上传的前提下此事件可能会触发多次。
uploadProgress	file {File}File对象 percentage {Number}上传进度	上传过程中触发，携带上传进度。
uploadError	file {File}File对象 reason {String}出错的code	当文件上传出错时触发。
uploadSuccess	file {File}File对象 response {Object}服务端返回的数据	当文件上传成功时触发。
uploadComplete	file {File} [可选]File对象	不管成功或者失败，文件上传完成时触发。