web 前端常用组件【06】Upload 控件

因为有万恶的IE存在，所以当Web项目初始化并进入开发阶段时。

如果是项目经理，需要知道客户将会用什么浏览器来访问系统。

明确知道限定浏览器的情况下，你才能从容的让手下的封装必要的前端组件。

本篇文章试图从常见的上传方式和组件进行分析，仅局限与前端，至于后端需依据业务复杂度，自行拿捏实现方式，若文中有纰漏，欢迎拍砖！

1. Input type="file" 也可以性感

当然你也可以不用任何成熟的上传组件，表单提交文件，像这样：

<form action="<%=request.getContextPath()%>/uploadfile" method="POST" enctype="multipart/form-data">  yourfile: <input type="file" name="myfiles"/><br/>  <input type="submit"/>
</form>

多个文件一起提交，添加里面的 input 选项即可，但 name 名称需要一致。

当然你也可以在提交文件的时候，提交一些其他的参数数据上去，像下面这样：

<form action="<%=request.getContextPath()%>/uploadfile" method="POST" enctype="multipart/form-data">  username: <input type="text" name="username"/><br/>  password: <input type="password" name="password"/><br/>  yourfile: <input type="file" name="myfiles"/><br/>  yourfile: <input type="file" name="myfiles"/><br/>  yourfile: <input type="file" name="myfiles"/><br/>  <input type="submit"/>
</form>

注意其中的 enctype 设置为multipart/form-data。

这种上传文件的方式，优缺点显而易见，不需要使用任何第三方 js，纯天然 html 标签、走到哪用到哪、没有浏览器障碍.....

对于多变的项目需求，比如这些特性：实时上传的进度条、能拖拽文件上传、上传前压缩、MD5加密验证等.....

你需要耐着性子自己实现，有造好的轮子，你为什么不用呢？

所以说这种性感撩人的 <input type="file"> 的标签能出现的项目，定位在小型简单、客户好说话的web应用中。

2. Uploadify 双版本上传组件

这个组件想必是用的比较广泛，提供 Flash 和 HTML5 两个不同的版本，能让你避免很多浏览器兼容性的问题。

支持显示文件上传实时进度条，拖拽文件上传、多样化的参数配置、高度可定制化....能满足绝大部分项目的上传需求。

官网地址：http://www.uploadify.com/

其中 Flash 版是免费下载的，但 HTML5 版本需要掏钱，如果你需要H5 Version，请在评论区留邮箱。

使用这个组件的前提，需要先引入 Jquery：

<script type="text/javascript" src="/style/js/jquery.js"></script>
<script type="text/javascript" src="/style/js/jquery.uploadify.min.js"></script>
<style type="text/css" src="/style/js/uploadify.css"></style><div class="updiv"><div class="upfileAfter"><a href="javascript:$('#upfileBtn').uploadify('upload','*')">开始上传</a></div><a href="#" id="upfileBtn">选择文件</a>
</div>

初始化组件方法(具体的参数设置和回调函数的入参请查阅官方文档):

$("#upfileBtn").uploadify({'debug': false,// 开启调试'auto': false,// 是否自动上传//'simUploadLimit' : 3,  //并发上传数量[falsh版不生效]//'successTimeout': 30,// 默认值30秒，文件上传完成时等待服务器响应的时间，之后显示成功信息。'fileObjName' : 'file','swf': XX+ "/style/js/uploadifynochange/uploadify.swf",'uploader': XX + '/service/uploadFile',// 上传处理程序'formData': {'fjzlDm': '', timeStamp: ''},'multi': true,// 是否支持多文件上传'width': '95px',// 浏览按钮的宽度'height': '30px',// 浏览按钮的高度'progressData' : 'speed', //文件进度条的样式'buttonText': '<i class="icon icon-file icon-white"></i> 选择文件', //按钮文字'fileSizeLimit': '10240',//上传文件大小限制'fileTypeExts': '*.bmp;*.png;*.jpeg;*.jpg;*.gif',//可上传的文件类型'overrideEvents': ['onDialogClose','onUploadSuccess','onUploadError'],'onFallback': function () {alert("您未安装FLASH控件，无法上传图片！请安装FLASH控件后再试。");// 检测FLASH失败调用
    },'onDialogClose': function () {alert("Dialog  Close......");},'onUploadSuccess': function (file, data, response) {alert("UploadSuccess......");},'onUploadError' : function () {alert("Upload   Error......");}
});

网上有很多上传组件都是修改 Uploadify 的源码的某一部分，然后重新命名的。

这个组件在项目中表现确实不错，使用 Flash version 浏览器中只需要安装 Flash Player 即可。

当下浏览器中不安装 Flash Player 的确找不出几个。

但不置可否的是 Flash 效率没有 H5 的高，兼容性和稳定性必须舍弃一部分，让两者都有相对最优解。

3. Web Uploader 百度技术团队开源力作

Webuploader 是由百度 Fex-team 团队开发，官网地址：http://fex.baidu.com/webuploader/

除了 Uploadify 的所有特性，最吸引人的特点是文件可以分片并发上传、同一组件内部决定使用 Flash 还是 H5 上传....

最后出场的一般都是压轴人物，不否认的是现在我们中项目中使用的就是 Web Uploader 组件。

不在为浏览器的兼容性而频繁更换组件调整代码，Uploader 会根据运行环境切换上传的方式，让你更省心。

<script type="text/javascript" src="/style/js/jquery.js"></script>
<script type="text/javascript" src="/style/js/webuploader.min.js"></script>
<style type="text/css" src="/style/js/webuploader.css"></style><div id="uploader" class="wu-example"><div id="thelist" class="uploader-list"></div><div class="btns" style="position: relative;display: inline-block"><div id="picker"><i class="glyphicon glyphicon-plus"></i>点击添加文件</div><a href="#" id="up-all">开始上传</a></div>
</div>

初始化组件方法(具体的参数设置和回调函数的入参请查阅官方文档):

var uploader = WebUploader.create({// swf文件路径swf:  '/style/js/webuploade/Uploader.swf',// 文件接收服务端。server: '/service/uploadFile',auto: false,formData: {paramA: 'paramA'},// 选择文件的按钮。可选。// 内部根据当前运行是创建，可能是input元素，也可能是flash.pick: '#picker'});$("#up-all").on("click",function(){uploader.upload();});// 当有文件被添加进队列的时候uploader.on('fileQueued', function (file) {$("#thelist").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('uploadError', function (file) {$('#' + file.id).find('p.state').text('上传出错');});uploader.on('uploadComplete', function (file) {$('#' + file.id).find('.progress').fadeOut();});uploader.on('startUpload', function () {uploader.option('formData', {'paramA': ''});});

View Code

Uploadify 和 Uploader 都可以动态的添加表单参数。

个人偏向于喜欢百度的这款 Uploader，但仁者见仁智者见智，多几种选择未尝不是好事情。

还需要注意的是，在实现获取上传文件的过程中，我发现只有表单提交上去的多文件是在一次请求当中。

而 Uploadify 和 Uploader 都是点击全部上传后，多次请求后端的 Action,每次只携带一个文件。

请求次数等于你的文件上传次数，我在实现过程中是通过添加时间戳的方式解决的该问题。

也有可能是我使用的有问题，文件上传后肯定需要和具体的业务挂钩，业务问题这里就不赘述了。