本文详细介绍如何使用jquery.form.js插件将传统Form表单提交转换为Ajax异步提交。文章通过完整示例演示了引入依赖、配置options对象、处理服务器返回的JSON数据以及在beforeSubmit中进行前端验证的具体步骤,帮助开发者简化AJAX表单处理流程。
jquery.form.js实现Ajax提交概述
本文详细介绍如何使用jquery.form.js插件将传统Form表单提交转换为Ajax异步提交的方法,供开发者参考。
该框架集成了表单提交、数据验证及文件上传功能。需要注意的是,此插件必须与jQuery完整版库配合使用,若使用min压缩版则无法生效。其核心原理是通过JavaScript将Form表单数据组装为Ajax所需的url和data参数,底层仍依赖Ajax机制完成提交。虽然手动编写也可实现,但借助该框架能显著简化开发过程。
基础使用示例
一、最简单例子:
第一步:引用js
<!--这里的min是自己用js压缩工具对完整版进行的压缩
并不是真正的min,所以好使-->
<script type="text/javascript" src="js/jquery-1.7.min.js"></script>
<script type="text/javascript" src="js/jquery.form.js"></script>
第二步:页面写form
<form id="showDataForm"
action="/024pm/f_shopUser.do?method=login" method="post">
<input type="text" value="" name="name" maxlength="2"/>
<input type="password" value="" name="password" maxlength="2"/>
<input type="submit" value="提交"/>
</form>
<div id="output1"
style="width:1000px;height:200px;background-color:#eee;">
</div>
第三步:写js调用jquery.form.js,对form表单进行ajax提交
$(document).ready(function() {
var options = {
target: '#output1',
// 从服务传过来的数据显示在这个div内部
也就是ajax局部刷新
beforeSubmit: showRequest,
// ajax提交之前的处理
success: showResponse
// 处理之后的处理
};
$('#showDataForm').submit(function() {
$(this).ajaxSubmit(options);
return false;
//非常重要,如果是false,则表明是不跳转
//在本页上处理,也就是ajax,如果是非false,则传统的form跳转。
});
});
function showResponse(responseText, statusText, xhr, $form) {
alert(xhr.responseText+"=="+$form.attr("method")+'status: ' +
statusText + '\n\nresponseText: \n' + responseText);
//xhr:说明你可以用ajax来自己再次发出请求
//$form:是那个form对象,是一个jquery对象
//statusText:状态,成功则为success
//responseText,服务器返回的是字符串(当然包括html,不包括json)
}
function showRequest(formData, jqForm, options) {
//formData是数组,就是各个input的键值map数组
//通过这个方法来进行处理出来拼凑出来字符串。
//formData:拼凑出来的form字符串,比如name=hera&password,
//其实就是各个表单中的input的键值对,
//如果加上method=XXXX,那也就是相当于ajax内的data。
var queryString = $.param(formData);
alert(queryString+"======"+formData.length);
for (var i=0; i < formData.length; i++) {
alert(formData[i].value+"==============="+formData[i].name);
}
//jqForm,jquery form对象
var formElement = jqForm[0];
alert($(formElement).attr("method"));
alert($(jqForm[0].name).attr("maxlength"));
//非常重要,返回true则说明在提交ajax之前你验证
//成功,则提交ajax form
//如果验证不成功,则返回非true,不提交
return true;
}
options对象配置详解
二、options对象内的值有哪些?
主要的有那么几个常用的属性:
var options = {
target: '#output1',
data:{param1:"我自己的第一个额外的参数"},
//这个参数是指通过ajax来给服务器提交除了form内部input的参数
//在后台中使用String param1=req.getParameter("param1");获取。
// dataType: null,
dataType:'json',
//这个参数值的是服务器返回的数据类型,默认的是null
//也就是服务器可以默认返回字符串,然后将这些字符串放在target内部
//当然还有json、xml,其中最常用的便是null和json
//对于json的使用,我们会稍后讲解到
beforeSubmit: showRequest,
success: successRes,
type:'POST'
//提交方式,默认是自己在form标签上指定的method
//如果没有指定,则使用get。
url:''
//重新提交的url,即url可以在form中配置
//也可以在这里配置。
};
服务器JSON数据解析
三、如何解析服务器传递过来的json数据
使用jQuery原生ajax方法时,若服务器返回json数据,可自动转换为js对象并通过json.xxx访问。对于该框架,需按以下步骤操作: 1)在options参数中指定dataType为'json'; 2)通过框架发起提交; 3)服务器接收请求; 4)服务器返回json格式数据; 5)页面js接收json。 关键在于第五步,需在success回调函数内部进行如下处理:
var options = {
target: '#output1',
dataType:'json',
beforeSubmit: showRequest,
success: successRes
//注意了,successRes方法看起来并没有有参数
//但是为何下面的方法就能有参数了呢,是可以这么传递的。
function successRes(jsonData){
alert(jsonData.param1);
}
表单前端验证实现
四、如何通过这个框架进行简单的验证呢?
验证逻辑应在beforeSubmit方法内部执行。该方法已传入jqform对象和formData,可利用这两个参数获取对应的input元素并进行自定义判定。若判定成功则返回true以提交Ajax表单;若验证失败,则返回非true值以阻止提交。
function showRequest(formData, jqForm, options) {
for (var i=0; i < formData.length; i++) {
alert(formData[i].value+"========"+formData[i].name);
if (!formData[i].value) {
//验证是否填写完整
alert('input有没有填写的选项');
//如果验证不通过,则返回false
return false;
}
}
var formElement = jqForm[0];
alert($(jqForm[0].name).attr("maxlength"));
return true;
}
jquery.form.js文件点击此处本站下载。
希望本文所述对大家的jQuery程序设计有所帮助。