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

来源：互联网发布：网络拾音头编辑：程序博客网时间：2024/05/21 18:39

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

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

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

HTML

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

?
1
2
3
<linkrel="stylesheet"type="text/css"href="css/webuploader.css">
<scriptsrc="http://cdn.bootcss.com/jquery/1.12.4/jquery.min.js"></script>
<scripttype="text/javascript"src="js/webuploader.min.js"></script>

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

?
1
2
3
4
<divid="uploadimg">
 <divid="fileList"class="uploader-list"></div>
 <divid="imgPicker">选择图片</div>
</div>

JAVASCRIPT

首先创建Web Uploader实例：

?
1
2
3
4
5
6
7
8
9
10
11
12
varuploader = 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上传技术汇总》进行深入学习和研究。

0 0