使用jquery的ajax提交文件上传

以前的项目大多的使用jquery的插件来进行文件上传,对于就只引用jquery而不使用插件来上传文件之前未有写过,最近项目里有写到和用到,就记录一下,以后方便查找。

提示:存在浏览器皆容问题,谨慎使用。

HTML代码:

<form id="infoLogoForm" enctype='multipart/form-data'>
    <div class="cnt-updateWrapper" style="display: none">
        <div>
            <div id="loadImg" class="cnt-img-content">
                <img id="logo" class="ctn-uploadImg" src="${ctx}/static/images/u8385.png" draggable="false">
                <div id="licenseBox" class="ctn-licence">
                    点击我上传图片
                    <input type="file" id="ctn-input-file" name="file" accept="image/*" style="height:40px">
                </div>
            </div>
        </div>
        <div>上传成功后,请点击保存后才能生效</div>
        <div>
            <button id="infoLogoSaveBt" class="btn btn-default cnt-save" type="button">保存</button>
        </div>
    </div>
</form>

JS代码:

var uploading = false;

$("#ctn-input-file").on("change", function(){
    if(uploading){
        alert("文件正在上传中,请稍候");
        return false;
    }
    $.ajax({
        url: ctx + "/xxx/upload",
        type: 'POST',
        cache: false,
        data: new FormData($('#infoLogoForm')[0]),
        processData: false,
        contentType: false,
        dataType:"json",
        beforeSend: function(){
            uploading = true;
        },
        success : function(data) {
            if (data.code == 1) {
                $("#logo").attr("src", data.msg);
            } else {
                showError(data.msg);
            }
            uploading = false;
        }
    });
});

其中关键要素:

1、contentType:

(默认: "application/x-www-form-urlencoded") 发送信息至服务器时内容编码类型。默认值适合大多数情况。如果你明确地传递了一个content-type给 $.ajax() 那么他必定会发送给服务器(即使没有数据要发送)

2、processData

(默认: true) 默认情况下,通过data选项传递进来的数据,如果是一个对象(技术上讲只要不是字符串),都会处理转化成一个查询字符串,以配合默认内容类型 "application/x-www-form-urlencoded"。如果要发送 DOM 树信息或其它不希望转换的信息,请设置为 false

3、FormData

XMLHttpRequest Level 2添加了一个新的接口FormData.利用FormData对象,我们可以通过JavaScript用一些键值对来模拟一系列表单控件,我们还可以使用XMLHttpRequest的send()方法来异步的提交这个"表单".比起普通的ajax,使用FormData的最大优点就是我们可以异步上传一个二进制文件.

参见:https://developer.mozilla.org/zh-CN/docs/Web/API/FormData

浏览器的兼容情况:

桌面浏览器:

Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari
Basic support 7+ 4.0 (2.0) 10+ 12+ 5+
支持filename参数 (Yes) 22.0 (22.0) ? ? ?