JQuery 常用上传组件

Posted 2020-07-26 Orson

    因为有万恶的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,每次只携带一个文件。

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

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