使用 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 对象
ajaxForm
和 ajaxSubmit
都支持众多的选项参数,这些选项参数可以使用一个 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 来提交,同样的,它也支持文件上传!一些其它的用法,请参照前面给出的说明就可以了!