正文

webuploader.js

IP云
IP云V管理员/3 阅读
10/31
提示：扫一扫查出行
【扫一扫了解最新限行尾号】
复制提示

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对象不管成功或者失败，文件上传完成时触发。