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': ''});
        });

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

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

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

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

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

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