百度上传控件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