jquery.form.js实现将form提交转为ajax方式提交的方法

作者:资源驿站

时间:2026-10-29

浏览:85

本文详细介绍如何使用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程序设计有所帮助。

实用工具推荐

电子包浆

绿化、压缩、噪点和虚拟水印,自由调节做旧程度。

使用 ›
图片压缩

选择画质和输出格式,预览压缩前后的大小。

使用 ›
相关文章