使用 ajax 提交 form 表单 和 ajax 文件上传

使用 ajax 请求数据,很多人都会,比如说:

$.post(path, { data: data }, function (data) {
    // ...
}, "json");

又或者是这样的 ajax

$.ajax({
    url: "${pageContext.request.contextPath}/public/testupload",
    type: "post",
    data: {username:username},
    success: function(data) {
        window.clearInterval(timer);
        console.log("over..");
    },
    error: function(e) {
        alert("错误!!");
        window.clearInterval(timer);
    }
});

同样的,很多人也会。但是写的越多就越会发现,这样子虽然可以避免刷新页面,但是我们要写大量的 js 来到得数据:

var username = $("#username").val();
var password = $("#password").val();
// ...

如果数量少的话,那还没有什么,但是如果数据十分大的话,那就十分的麻烦,那有没有什么简单的方法呢?答案肯定有的!下面介绍两种方法,可以极大的提高开发人员的效率。

使用 FormData 对象

FormData 对象是 html5 的一个对象,目前的一些主流的浏览器都已经兼容。额,如果你说 ie8 什么的,那我们还是来谈谈今天的天气吧,我没听见。呵呵,开个玩笑,不支持 FormData 的,可以使用方法二,下面会介绍。接着说 FormData,它是一个 html5 的 javascript 对象,非常的强大。

FormData 可以凭空创建一个对象,然后往这个对象里面添加数据,然后直接提交,不需要写一行 html 代码,如下:

var form = new FormData();
form.append("username", "zxj");
form.append("password", 123456);
var req = new XMLHttpRequest();
req.open("post", "${pageContext.request.contextPath}/public/testupload", false);
req.send(form);

这样就可以向浏览器发送表单数据了,或者也可以使用 Jquery 这样发送:

var form = new FormData();
  form.append("username", "zxj");
  form.append("password", 123456);
 $.ajax({
    url: "${pageContext.request.contextPath}/public/testupload",
    type: "post",
    data: form,
    processData: false,
    contentType: false,
    success: function(data) {
        window.clearInterval(timer);
        console.log("over..");
    }
});

这样也可以直接发送数据到后台。

其次 FormData 还支持直接从 html 中的表单生成数据,就是在html页面中已经有数据了,然后 FormData 可以直接把这个表单的数据写入这个对象,然后直接提交给后台。

代码如下,先给出 html 代码:

<form id="tf">
    <input type="file" name="img"/>
    <input type="text" name="username"/>
    <input type="button" value="提交" onclick="test();"/>
</form>

大家注意到没有,里面可是有文件!

没错,FormData 还支持困扰众多开发者已久的 ajax 的上传文件,以前我们上传文件,需要写一个表单直接刷新提交,但是这里不需要,下面给出提交代码:

function test(){
    var form = new FormData(document.getElementById("tf"));
    // var req = new XMLHttpRequest();
    // req.open("post", "${pageContext.request.contextPath}/public/testupload", false);
    // req.send(form);
    $.ajax({
        url: "${pageContext.request.contextPath}/public/testupload",
        type: "post",
        data: form,
        processData: false,
        contentType: false,
        success: function(data) {
            window.clearInterval(timer);
            console.log("over..");
        },
        error: function(e) {
            alert("错误!!");
            window.clearInterval(timer);
        }
    });        
    get(); // 此处为上传文件的进度条
}

就是这么简单,使用 FormData,在构造这个对象的时候,把表单的对象,作为一个参数放进去,就可以了,然后 FormData,就会得到这个表单对象里面的所有的参数,甚至我们在表单中,都不需要声明 enctype ="multipart/form-data",就可以直接提交。

使用 FormData,第一是在提交表单的时候,不需要写大量的 js 来获得表单数据,直接把表单对象构造就行了。第二就是可以直接异步上传文件,简单牛逼爆了!

注意:使用 FormData 提交的时候,大家会注意到表单提交的是 request payload,具体有兴趣的同学可以自己百度,它不是之前的 Form data 提交的,所以后台也是要经过处理的,比如 springMVC 就需要配置。

<!-- 配置nultipartresolver,注意:id名必须这样写,不然会报错 -->
<bean id="multipartResolver" class="org.springframework.web.multipart.commons.CommonsMultipartResolver">
    <property name="defaultEncoding" value="UTF-8"></property>
    <property name="maxInMemorySize" value="10240000"></property>
</bean>

不然会接收不到数据,当然,后台的话,我们这里就先不管。

使用 jquery.form.js

Jquery.form.js 是一个强大的表单插件,其大量的提供了表单操作的各种简便的方法,下面给出一些 Jquery.form.js 的说明。

接口

接口 说明 参数 用例
ajaxForm 增加所有需要的事件监听器,为ajax提交表单做准备。ajaxForm并不能提交表单。在document的ready函数中,使用ajaxForm来为ajax提交表单进行准备。 接受0个或1个参数。参数可以是一个回调函数,也可以是一个Options对象。 $("#formid").ajaxForm();
ajaxSubmit 使用ajax提交表单。 接受0个或1个参数。参数可以是一个回调函数,也可以是一个Options对象。 $("#formid").ajaxSubmit(); 或 $("#formid").submit(function(){ $(this).ajaxSubmit();return false;});
formSerialize 将表单串行化(或序列化)为一个查询字符串。这个方法将返回以下格式的字符串:name1=value1&name2=value2。 $("#formid").formSerialize();
fieldSerialize 将表单的字段元素串行化(或序列化)为一个查询字符串。当只有部分表单字段需要进行串行化(或序列化)时,使用这个就很方便了。返回以下格式的字符串:name=value1&name2=value2。 $("#formid .specialFields").fieldSerialize();
fieldValue 返回匹配插入数组中的表单元素值。该方法以数组的形式返回数据。如果元素值被判定可能无效,则数组为空。 $("#formid :password").fieldValue();
resetForm 将表单恢复到初始状态。 $("#formid").resetForm();
clearForm 清除表单元素。该方法将所有的 text、password、textarea 置空,清除 select 元素中的选定,以及所有 radio 按钮和 checkbox 按钮重置为非选定状态。 $("#formid").clearForm();
clearFields 清除字段元素。只有部分表单元素需要清除时方便使用。 $("#formid .specialFields").clearFields();

Options 对象

ajaxFormajaxSubmit 都支持众多的选项参数,这些选项参数可以使用一个 Options 对象来提供。

选项 说明 默认值
target 指明页面中由服务器响应进行更新的元素。元素的值可能被指定为一个jQuery选择器字符串、一个jquery对象、一个DOM元素。 默认值:null
url 指定提交表单数据的URL。 默认值:表单的action属性值
type 指定提交表单数据的方法(method):“GET”或“POST”。 默认值:GET
beforeSubmit 表单提交前被调用的回调函数。如果回调函数返回false表单将不被提交。回调函数带三个调用参数:数组形式的表单数据,jQuery表单对象,以及传入ajaxForm/ajaxSubmit中的Options对象。 默认值:null
success 表单成功提交后调用的回调函数。然后dataType选项值决定传回responseText还是responseXML的值。 默认值:null
dataType 返回的数据类型:null、"xml"、"script"、"json"其中之一。 默认值:null
resetForm 表示如果表单提交成功是否进行重置。 默认值:null
clearForm 表示如果表单提交成功是否清除表单数据。 默认值:null

那么现在来说一些它的主要用法吧!

它也支持对一个表单的 ajax 提交,而且提交方式更为简便,如下:

<form id="tf">
    <input type="file" name="img"/>
    <input type="text" name="username"/>
    <input type="button" value="提交" onclick="test();"/>
</form>

下面使用 jquery.form.js 的表单插件来提交表单。

$("#tf").ajaxSubmit();

额,就是这么简单,你也不要问我为什么就是这么简单,然后它就是会把整个表单,作为一个 ajax 来提交,同样的,它也支持文件上传!一些其它的用法,请参照前面给出的说明就可以了!

如果觉得这对你有用,请随意赞赏,给与作者支持
评论 0
最新评论