webuploader.js

麹培
2023-12-01

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

 

常用的事件说明:

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

转载于:https://www.cnblogs.com/jasonxiaoqinde/p/7841393.html

 类似资料:

相关阅读

相关文章

相关问答