jquery组件WebUploader文件上传用法详解

WebUploader是由Baidu WebFE(FEX)团队开发的一个简单的以HTML5为主,FLASH为辅的现代文件上传组件,下文来为各位演示一下关于jquery WebUploader文件上传组件的用法。

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

接下来我以图片上传实例，给大家讲解如何使用WebUploader。

HTML

我们首先将css和相关js文件加载。

?

1 2 3

< link rel = "stylesheet" type = "text/css" href = "css/webuploader.css" > < script src = "http://cdn.bootcss.com/jquery/1.12.4/jquery.min.js" ></ script > < script type = "text/javascript" src = "js/webuploader.min.js" ></ script >

然后我们需要准备一个按钮#imgPicker，和一个用来存放添加的文件信息列表的容器#fileList，在body中加入如下代码：

?

1 2 3 4

< div id = "uploadimg" >   < div id = "fileList" class = "uploader-list" ></ div >   < div id = "imgPicker" >选择图片</ div > </ div >

JAVASCRIPT

首先创建Web Uploader实例：

?

1 2 3 4 5 6 7 8 9 10 11 12

var uploader = WebUploader.create({   auto: true , // 选完文件后，是否自动上传   swf: 'js/Uploader.swf' , // swf文件路径   server: 'upload.php' , // 文件接收服务端   pick: '#imgPicker' , // 选择文件的按钮。可选   // 只允许选择图片文件。   accept: {   title: 'Images' ,   extensions: 'gif,jpg,jpeg,bmp,png' ,   mimeTypes: 'image/*'   } });

接着监听fileQueued事件，即当有文件添加进来的时候，通过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

uploader.on( 'fileQueued' , function ( file ) {   var $list = $( "#fileList" ),   $li = $(   '<div id="' + file.id + '" class="file-item thumbnail">' +   '<img>' +   '<div class="info">' + file.name + '</div>' +   '</div>'   ),   $img = $li.find( 'img' );         // $list为容器jQuery实例   $list.append( $li );      // 创建缩略图   uploader.makeThumb( file, function ( error, src ) {   if ( error ) {   $img.replaceWith( '<span>不能预览</span>' );   return ;   }      $img.attr( 'src' , src );   }, 100, 100 ); //100x100为缩略图尺寸 });

最后是上传状态提示了，当文件上传过程中, 上传成功，上传失败，上传完成都分别对应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 26 27 28 29 30 31 32 33 34 35 36 37 38

// 文件上传过程中创建进度条实时显示。 uploader.on( 'uploadProgress' , function ( file, percentage ) {   var $li = $( '#' +file.id ),   $percent = $li.find( '.progress span' );      // 避免重复创建   if ( !$percent.length ) {   $percent = $( '<p class="progress"><span></span></p>' )   .appendTo( $li )   .find( 'span' );   }      $percent.css( 'width' , percentage * 100 + '%' ); });    // 文件上传成功，给item添加成功class, 用样式标记上传成功。 uploader.on( 'uploadSuccess' , function ( file, res ) {   console.log(res.filePath); //这里可以得到上传后的文件路径   $( '#' +file.id ).addClass( 'upload-state-done' ); });    // 文件上传失败，显示上传出错。 uploader.on( 'uploadError' , function ( file ) {   var $li = $( '#' +file.id ),   $error = $li.find( 'div.error' );      // 避免重复创建   if ( !$error.length ) {   $error = $( '<div class="error"></div>' ).appendTo( $li );   }      $error.text( '上传失败' ); });    // 完成上传完了，成功或者失败，先删除进度条。 uploader.on( 'uploadComplete' , function ( file ) {   $( '#' +file.id ).find( '.progress' ).remove(); });

到这里，我们就实现了一个简单的图片上传实例，点击“选择图片”会弹出文件选择对话框，当选择图片后，即进入上传图片流程，会将图片对应的缩略图现实在列表里。

常用选项设置与事件调用

Web Uploader提供了丰富的API选项设置与事件调用。

常用的事件说明：

更多精彩内容，请点击《jQuery上传操作汇总》，《ajax上传技术汇总》进行深入学习和研究。