百度上传控件WebUploader介绍

功能介绍

WebUploader是由Baidu开发的以HTML5为主，FLASH为辅的现代文件上传组件。在现代的浏览器里面能充分发挥HTML5的优势，同时又不摒弃主流IE浏览器，沿用原来的FLASH运行时，兼容IE6+，iOS 6+, android 4+。两套运行时，同样的调用方式，可供用户任意选用。具有以下特点

1. 浏览器兼容性强

简单的以HTML5为主，FLASH为辅的现代文件上传组件。在现代的浏览器里面能充分发挥HTML5的优势，同时又不摒弃主流IE浏览器，沿用原来的FLASH运行时，兼容IE6+，iOS 6+, android 4+。两套运行时，同样的调用方式，可供用户任意选用。

2. 分片、并发

分片与并发结合，将一个大文件分割成多块，并发上传，极大地提高大文件的上传速度。
当网络问题导致传输错误时，只需要重传出错分片，而不是整个文件。另外分片传输能够更加实时的跟踪上传进度。

3. 预览、压缩

支持常用图片格式jpg,jpeg,gif,bmp,png预览与压缩，节省网络数据传输。
解析jpeg中的meta信息，对于各种orientation做了正确的处理，同时压缩后上传保留图片的所有原始meta数据。

4. 多途径添加文件

支持文件多选，类型过滤，拖拽(文件&文件夹)，图片粘贴功能。
粘贴功能主要体现在当有图片数据在剪切板中时（截屏工具如QQ(Ctrl + ALT + A), 网页中右击图片点击复制），Ctrl + V便可添加此图片文件。

5. HTML5 & FLASH

兼容主流浏览器，接口一致，实现了两套运行时支持，用户无需关心内部用了什么内核。
同时Flash部分没有做任何UI相关的工作，方便不关心flash的用户扩展和自定义业务需求。

6. MD5秒传

当文件体积大、量比较多时，支持上传前做文件md5值验证，一致则可直接跳过。
如果服务端与前端统一修改算法，取段md5，可大大提升验证性能，耗时在20ms左右。

7. 易扩展、可拆分

采用可拆分机制,将各个功能独立成了小组件，可自由搭配。采用AMD规范组织代码，清晰明了，方便高级玩家扩展。

官方网站：http://fex.baidu.com/webuploader/

开发示例

引入JS和CSS

<script type="text/javascript" src='<%=path%>/js/jquery-1.10.2.min.js'></script>    
<link rel="stylesheet" type="text/css" href="<%=path%>/js/webuploader-0.1.5/webuploader.css">
<script type="text/javascript" src="<%=path%>/js/webuploader-0.1.5/webuploader.min.js"></script>

Webuploader包含以下文件，可根据需要选择引入

├── Uploader.swf                      // SWF文件，当使用Flash运行时需要引入。
├── webuploader.js                    // 完全版本。
├── webuploader.min.js                // min版本

├── webuploader.flashonly.js          // 只有Flash实现的版本。
├── webuploader.flashonly.min.js      // min版本
├── webuploader.html5only.js          // 只有Html5实现的版本。
├── webuploader.html5only.min.js      // min版本
├── webuploader.withoutimage.js       // 去除图片处理的版本，包括HTML5和FLASH.
└── webuploader.withoutimage.min.js   // min版本

文件选择区域

<div id="uploader" style="width:80%">
        <div id="fileDragContainer"  class="panel panel-info" style="width:80%">
            <div class="panel-heading">
                <h4>
                          请将简历拖拽至上传区
                </h4>
            </div>
        <div id="fileList" style="weight:500px;height:300px;overflow-y :auto;border:1px solid #BCE8F1"></div>
    </div>
    <div class="btns">
        <div id="picker"><i class="icon-folder-open"></i>请选择简历</div>
        <button id="btnUpload" class="btn btn-primary"><i class="icon-arrow-up"></i>开始上传</button>
    </div>
</div>

WebUploader初始化

var uploader = WebUploader.create({
    //指定Drag And Drop拖拽的容器，如果不指定，则不启动拖拽
    dnd:'#fileDragContainer',
    //是否禁掉整个页面的拖拽功能，如果不禁用，图片拖进来的时候会默认被浏览器打开。
    disableGlobalDnd :document.body,
    //指定监听paste事件的容器，如果不指定，不启用此功能。此功能为通过粘贴来添加截屏的图片。建议设置为document.body
    paste:document.body,
    // swf文件路径,在IE9以下使用swf上传
    swf : '<%=path%>/js/webuploader-0.1.5/Uploader.swf',
    // 文件接收服务端地址
    server : '<%=path%>/upload',
    // 选择文件的按钮。可选。
    // 内部根据当前运行是创建，可能是input元素，也可能是flash.
    pick : '#picker',
    // 不压缩image, 默认如果是jpeg，文件上传前会压缩一把再上传！
    resize : false,
    // 设置文件上传域的name,默认为file
    fileVal : 'upfile',
    auto : false,
    //可通过formData将默认参数传递给服务器
    formData : {
        initargs : 'initArgs'
    },
    //指定接受哪些类型的文件
    accept:{
        title: '',
       extensions: 'doc,docx,html,mht,xls,xlsx,pdf',
        mimeTypes: ''
    },
    //文件上传线程数
    threads:1
});

参数详细说明见http://fex.baidu.com/webuploader/doc/index.html#WebUploader_Uploader

WebUploader方法

$("#btnUpload").click(function() {
//动态设置参数
    uploader.options.formData.args ="1";
//上传方法
uploader.upload();
});

方法详细说明见：http://fex.baidu.com/webuploader/doc/index.html

WebUploader事件

//文件加入队列事件
uploader.on('fileQueued', function( file ) {
    $("#fileList").append( '<div id="' + file.id + '" class="item">' +'<h4 class="info">' + file.name + '</h4>' +
    '<p class="state">等待上传...</p>' +'</div>' );
});
//文件上传进度监控事件
uploader.on('uploadProgress', function( file, percentage ) {
    var $li = $( '#'+file.id ),
    $percent = $li.find('.progress .progress-bar');
    // 避免重复创建
    if ( !$percent.length ) {
        $percent = $('<div class="progress progress-striped active"><div class="progress-bar" role="progressbar" style="width: 0%"></div></div>')
        .appendTo( $li ).find('.progress-bar');
    }
    $li.find('p.state').text('上传中');
    $percent.css( 'width', percentage * 100 + '%' );
});
//文件上传成功事件
uploader.on( 'uploadSuccess', function( file,response) {
    //response是服务端的返回数据，json格式，如果服务端不是json格式，从response._raw中取数据，自行解析。
    if(response._raw =="ok"){
             $( '#'+file.id ).find('p.state').text('上传成功');
    $( '#'+file.id ).fadeOut(3000);
    }else{
        $( '#'+file.id ).find('p.state').text('上传失败');
        $( '#'+file.id ).fadeOut(3000);
    }           
});
//文件上传失败事件
uploader.on( 'uploadError', function( file ) {
    $( '#'+file.id ).find('p.state').text('上传出错');
});
//文件上传完成事件，不管成功或者失败，在文件上传完后都会触发uploadComplete事件
uploader.on( 'uploadComplete', function( file ) {
    $( '#'+file.id ).find('.progress').fadeOut();
});

事件详细说明见：
http://fex.baidu.com/webuploader/doc/index.html#WebUploader_Uploader_events