最近,要做文件上传功能,在同事推荐下,选择了webUploader插件。WebUploader是由Baidu WebFE(FEX)团队开发的一个简单的以HTML5为主,FLASH为辅的现代文件上传组件,详情请看官网(直接百度webUploader,应该是第一个)。挺好用的,于是小结一下。
1. 准备工作
1.1 先搭建服务,选用wamp/xamp或其他服务 1.2 下载webUploader 下载地址: https://github.com/fex-team/webuploader
2. 选用demo
点击选择图片(其他文件也可以)就可以上传啦!
遇到的几个问题
1. 上传稍微大一点(10M+)的文件可能会有点问题,文件名被改,文件也会出错。文件被重命名成file_*
2. 限制上传文件大小等配置
3. 上传文件至服务器地址修改 (自定义)
4. 在上传文件前事件
4.1 上传前文件格式检测
5. 根据自己需求要在上传前做验证
6. 获取已添加的所有文件对象
7.上传时,携带自定义参数
8.上传大图片被压缩,而其他文件没有问题
9. uploader.removeFile( file, true )无效, 执行getFiles()删除的文件还在file数组里
上传稍微大一点(10M+)的文件可能会有点问题,文件名被改,文件也会出错。文件被重命名成file_*,例如:file_58f4a2fc7dde0, 这问题也困扰我很久,在github webUploader的issue里,也发现有人有同样的问题,https://github.com/fex-team/webuploader/issues/263 但是我这里是没有解决。
后来查找官方API才找到答案,原来是大文件没有切片导致啊!!!!
解决办法: 在upload.js 中,uploader实例化的时候设置切片chunked: true,
在这位置,可以更改一些配置,如看”点击上传图片”不顺眼,想改成“上传文件”,就在pick那改。
还有的想把上传文件的大小限制改动下,也可以根据自己需求在这里的fileSizeLimit那里改。
fileNumLimit {int} [可选] [默认值:undefined] 验证文件总数量, 超出则不允许加入队列。
fileSizeLimit {int} [可选] [默认值:undefined] 验证文件总大小是否超出限制, 超出则不允许加入队列。
fileSingleSizeLimit {int} [可选] [默认值:undefined] 验证单个文件大小是否超出限制, 超出则不允许加入队列。
改成切片后,再上传文件,
成功! 完美。
那这里又存在一个疑问,那文件上传的位置在哪里更改呢?
在server/fileupload.php 中改targetDir和uploadDir
在server/fileupload.php 中改targetDir和uploadDir
a. 在上传文件前事件
//我自己的需求是,只能添加xml格式和zip格式文件 //webuploader.js input.on( 'change', function( e ) { var fn = arguments.callee, clone; //code /**下面检测文件格式的方法不推荐!不推荐!!! (webuploader实例化中有配置) 在file 对象中有个ext属性是文件格式的,可以用。 */
上传前文件格式检测
在webuploader实例化那里可以配置,详情看官网文档
我这里还有需要根据权限的不同去指定上传文件格式,我用个数组/字符串变量保存 (具体是字符串还是数组,请参看源码中怎么加,你就怎么加)
实际上在这里加,只是在你点击添加文件时,那个弹框就给你过滤了其他文件,留下你指定的文件类型。
如图。若用户吧把那个自定义文件下拉框换成全部文件,就可以添加其他文件了(刚刚自测了一把)。
显然,这与我们需求不符,uploader实例化配置accept只是个简单的过滤而已,
所以还是得在文件添加到控件中,就自己检测。(个人觉得,就按我上面的那样,一旦用户添加进来了,就里面检测,添加不通过直接打回去)
b. 根据自己需求要在上传前做验证
//在662行左右,点击时做验证 $upload.on('click', function() { if ( $(this).hasClass( 'disabled' ) ) { return false; }
c. 获取已添加的所有文件对象
//有时需要把所有文件做个判断啥的,就需要用到 var fileItem = uploader.getFiles(); //要文件添加进去了,才有用。在刚刚添加文件时,是无效的。 //uploader是一个实例
d. 上传时,携带自定义参数
//见uploader实例化 uploader.options.formData.houseName = houseName; uploader.options.formData.houseType = houseType; uploader.options.formData.address = district; //添加到实例化后就可以了,
//地址瞎写的,
e. 上传大图片被压缩,而其他文件没有问题
之前自己检测过,上传大文件(非图片)到服务器上,与上传前文件对比大小,是没有问题的。 但是今天同事说,他传的图片(8M)被压缩(400kb左右)了,刚刚开始还不信,毕竟之前自己检测过,上传后的文件和原文件的大小一致。 后来查官方文档才知道真被压缩了。 文档是这么说的
解决办法: 在uploader实例化的时候,加个参数 compress: false;
9. uploader.removeFile( file, true )无效, 执行getFiles()删除的文件还在file数组里
测试给我提个单,说删除有问题。
额·····
后来自己定位到,在点击删除时,执行到uploader.removeFile(file), 居然只是从视图中删除了? 没从file数组删除????
什么鬼?
后来查官方API,说只要把removeFile()方法后面加个true就可以了。然并卵。。。。
再去github issue查,这种问题还真有好几个,
不过都没有解决方法,最终找到个解决办法
https://github.com/fex-team/webuploader/pull/2049/commits/b5461ee16deece92dbb34d2253f4c6ab3b215c1d,
但是写的我糊里糊涂,没整明白(也许是我理解能力不好),自己尝试几次,终于搞好了。所以就写下来,记录下。
只要在webuploader.js 中加几行代码就好。
1. 在webuploader.js 中搜到 function Queue() 方法
2. 在里面添加 删除方法
_delFile : function(file){ for(var i = this._queue.length-1 ; i >= 0 ;i-- ){ if(this._queue[i] == file){ this._queue.splice(i,1); break; } } },
然后再在removeFile: function( file ) { 调用下就好了
最后附上一张gif,不骗你们啦~~
demo下载地址:https://www.qingsj.com/c/1-81-0.html
转载请注明:有客帮 » webUploader上传demo