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>
初始化组件方法(具体的参数设置和回调函数的入参请查阅官方文档):
![](https://images.cnblogs.com/OutliningIndicators/ContractedBlock.gif)
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': ''}); });
Uploadify 和 Uploader 都可以动态的添加表单参数。
个人偏向于喜欢百度的这款 Uploader,但仁者见仁智者见智,多几种选择未尝不是好事情。
还需要注意的是,在实现获取上传文件的过程中,我发现只有表单提交上去的多文件是在一次请求当中。
而 Uploadify 和 Uploader 都是点击全部上传后,多次请求后端的 Action,每次只携带一个文件。
请求次数等于你的文件上传次数,我在实现过程中是通过添加时间戳的方式解决的该问题。
也有可能是我使用的有问题,文件上传后肯定需要和具体的业务挂钩,业务问题这里就不赘述了。
作者:Orson
出处:http://www.cnblogs.com/java-class/
如果,您认为阅读这篇博客让您有些收获,不妨点击一下右下角的【推荐】
如果,您希望更容易地发现我的新博客,不妨点击一下左下角的【关注我】
如果,您对我的博客内容感兴趣,请继续关注我的后续博客,我是【Orson】
本文版权归作者和博客园共有,欢迎转载,但未经作者同意必须保留此段
声明,且在文章页面明显位置给出原文连接,否则保留追究法律责任的权利。