jQuery Form Plugin

最新推荐文章于 2024-09-08 08:40:24 发布

sujiaye520

最新推荐文章于 2024-09-08 08:40:24 发布

阅读量441

点赞数

分类专栏： JQuery 文章标签： jquery xmlhttprequest function 服务器 input semantic

本文链接：https://blog.csdn.net/dodo_yin/article/details/6690549

版权

JQuery 专栏收录该内容

12 篇文章 0 订阅

订阅专栏

在jQuery Form插件可以让你很容易的使用AJAX提交Form表单，主要方法ajaxForm和ajaxSubmit负责收集表单元素的信息,管理提交进程。这两种方法都是可配置的,让你完全控制Form提交。使用AJAX提交表单没有任何方式比JQuery Form插件更容易的了.

官网地址:www.malsup.com/jquery/form/：有文档说明和演示示例可供参考！

我简单使用了一下,jQuery Form插件有一下优点:
1.支持提交前验证.
2.支持提交后回调.
3.采用AJAX方式,有很好的用户体验
4.提交方式是灵活.只要指定要提交的form ID即可.想提交那个form.就可提交那个.同时提交参数可配置.
5.支持提交多种类型数据.如:xml,json等.

主要的函数：
1.ajaxForm
增加所有需要的事件监听器，为AJAX提交表单做好准备。ajaxForm不能提交表单。在document的ready函数中，使用ajaxForm来为AJAX提交表单进行准备。ajaxForm接受0个或1个参数。这个单个的参数既可以是一个回调函数，也可以是一个Options对象。

实例：
$('#myFormId').ajaxForm();

2.ajaxSubmit
马上由AJAX来提交表单。大多数情况下，都是调用ajaxSubmit来对用户提交表单进行响应。ajaxSubmit接受0个或1个参数。这个单个的参数既可以是一个回调函数，也可以是一个Options对象。

实例：
// 绑定表单提交事件处理器
$('#myFormId').submit(function() {
// 提交表单
$(this).ajaxSubmit();
// 为了防止普通浏览器进行表单提交和产生页面导航（防止页面刷新？）返回false
return false;
});

3.formSerialize
将表单串行化（或序列化）成一个查询字符串。这个方法将返回以下格式的字符串：name1=value1&name2=value2。这个方法返回一个字符串。

实例：
var queryString = $('#myFormId').formSerialize();
// 现在可以使用$.get、$.post、$.ajax等来提交数据
$.post('myscript.php', queryString);

4.fieldSerialize
将表单的字段元素串行化（或序列化）成一个查询字符串。当只有部分表单字段需要进行串行化（或序列化）时，这个就方便了。这个方法将返回以下格式的字符串：name1=value1&name2=value2。这个方法返回一个字符串。

实例：
var queryString = $('#myFormId .specialFields').fieldSerialize();

5.fieldValue
返回匹配插入数组中的表单元素值。从0.91版起，该方法将总是以数组的形式返回数据。如果元素值被判定可能无效，则数组为空，否则它将包含一个或多于一个的元素值。该方法返回数组。

实例：
// 取得密码输入值
var value = $('#myFormId :password').fieldValue();
alert('The password is: ' + value[0]);

6.resetForm
通过调用表单元素原有的DOM方法，将表单恢复到初始状态。

实例：
$('#myFormId').resetForm();

7.clearForm
清除表单元素。该方法将所有的文本（text）输入字段、密码（password）输入字段和文本区域（textarea）字段置空，清除任何select元素中的选定，以及将所有的单选（radio）按钮和多选（checkbox）按钮重置为非选定状态。

实例：
$('#myFormId').clearForm();

8.clearFields
清除字段元素。只有部分表单元素需要清除时才方便使用。

实例：
$('#myFormId .specialFields').clearFields();

jQuery Form插件的简单示例:
<%@ page language="java" pageEncoding="UTF-8"%>
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
   <title>My Jquery</title>
   <script type="text/javascript" src="<%=request.getContextPath()%>/jslib/jquery-1.4.2.js"></script>
   <script type="text/javascript" src="<%=request.getContextPath()%>/jslib/jquery.form.js"></script>
   <script type="text/javascript">
   // wait for the DOM to be loaded
        $(document).ready(function() {
         // bind 'myForm' and provide a simple callback function
            $('#myForm').ajaxForm(function() {
                alert("Thank you for your comment!");
            });
        });
        // attach handler to form's submit event
        $('#myFormId').submit(function() {
         // submit the form
         $(this).ajaxSubmit();
         // return false to prevent normal browser submit and page navigation
         return false;
        });
    </script>

</head>
<body>
   <form id="myForm" action="index.jsp" method="post">
    Name: <input type="text" name="name" />
    Comment:<textarea name="comment"></textarea>
    <input type="submit" value="Submit Comment" />
   </form>
</body>
</html>

前章介绍了使用AJAX提交Form表单的方法，其中主要的就是ajaxForm()和ajaxSubmit()，ajaxForm和ajaxSubmit都支持众多的选项参数，这些选项参数可以使用一个Options对象来提供。Options只是一个JavaScript对象，它包含了如下一些属性与值的集合：

Options对象的详解：

1.)target
指明页面中由服务器响应进行更新的元素。元素的值可能被指定为一个jQuery选择器字符串，一个jQuery对象，或者一个DOM元素。
默认值：null。

2.)url
重写或者指定表单的'action'属性。
默认值：表单的action属性值

3.)type
重写或者指定表单的'method' 属性,"GET"或"POST"。
默认值：表单的method属性值（如果没有找到默认为“GET”）。

4.)beforeSubmit
表单提交前被调用的回调函数，该方法通常被提供来运行预提交逻辑或者校验表单数据。如果"beforeSubmit"回调函数返回false，那么表单将不被提交。"beforeSubmit"回调函数带三个调用参数：数组形式的表单数据，jQuery表单对象，以及传入ajaxForm/ajaxSubmit中的Options对象。表单数组接受以下方式的数据：
[ { name: 'username', value: 'jresig' }, { name: 'password', value: 'secret' } ]
默认值：null

5.)success
表单成功提交后调用的回调函数。如果提供"success"回调函数，当从服务器返回响应后它被调用。然后由dataType选项值决定传回responseText还是responseXML的值。
默认值：null

6.)dataType
期望服务器的的回应的类型。null、"xml"、"script"或者"json"其中之一。dataType提供一种方法，它规定了怎样处理服务器的响应。这个被直接地反映到jQuery.httpData方法中去。下面的值被支持：
'xml'：如果dataType == 'xml'，将把服务器响应作为XML来对待。同时，如果“success”回调方法被指定，将传回responseXML值
'json'：如果dataType == 'json'，服务器响应将被求值，并传递到“success”回调方法，如果它被指定的话。
'script'：如果dataType == 'script'，服务器响应将求值成纯文本。
默认值：null（服务器返回responseText值）

7.)semantic
布尔标志，表示数据是否必须严格按照语义顺序来进行提交。注意：一般来说，表单已经按照语义顺序来进行了串行化（或序列化），除了type="image"的input元素。如果你的服务器有严格的语义要求，以及表单中包含有一个type="image"的input元素，就应该将semantic设置为true。
默认值：false

8.)resetForm
布尔标志，表示如果表单提交成功是否进行重置。
默认值：null

9.)clearForm
布尔标志，表示如果表单提交成功是否清除表单数据。
默认值：null

10.)在$.ajax options中用到的元素都可以用在这里:
如：timeout:3000

ajaxSubmit示例代码：
<%@ page language="java" pageEncoding="UTF-8"%>
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
   <title>My Jquery</title>
   <script type="text/javascript" src="<%=request.getContextPath()%>/jslib/jquery-1.4.2.js"></script>
   <script type="text/javascript" src="<%=request.getContextPath()%>/jslib/jquery.form.js"></script>
   <script type="text/javascript">
   $().ready(function() {
      var options = {
          target:        '#output2',
          beforeSubmit: showRequest,
          success:       showResponse
      };
      $('#myForm2').submit(function() {
          $(this).ajaxSubmit(options);
          return false;
      });
   });

   // pre-submit callback
   /**参数介绍
    formData：是一个数组,我们使用$.param来把它转化成字符串显示,form提交的时候该插件可以自动为你转换;
    jqForm：是一个jQuery对象，用来封装form元素，访问DOM元素可以这样：var formElement = jqForm[0];
　　 options：就是上面ajaxSubmit()中的Options对象;
   **/
   function showRequest(formData, jqForm, options) {
      var queryString = $.param(formData);
      alert('About to submit: \n\n' + queryString);
      return true;
   }

   // post-submit callback
   /**参数介绍
    responseText：
       通常作为html的相应，方法成功回调，XMLHttpRequest对象的responseText属性，
       如果Options对象的dataType属性设置'xml'的话，该参数就是XMLHttpRequest对象的responseXML属性，
       如果Options对象的dataType属性设置'json' 的话，该参数就是服务器返回的JSON对象 ;
    statusText：状态码;
　　 xhr：XMLHttpRequest对象;
    $form:;
   **/
   function showResponse(responseText, statusText, xhr, $form) {
      alert('status: ' + statusText + '\n\nresponseText: \n' + responseText);
   }
   </script>
</head>
<body>
    <form id="myForm2" action="myservlet" method="post">
   <div>
           <table>
           <tr><td>Name:</td><td><input name="Name" type="text" value="MyName2" /></td></tr>
           <tr><td>Check:</td><td>
               <input type="checkbox" name="Check" value="1" />
            <input type="checkbox" name="Check" value="2" />
               <input type="checkbox" name="Check" value="3" />
           </td></tr>
           </table>
           <input type="reset"   name="resetButton " value="Reset" />
           <input type="submit" name="submitButton" value="Submit1" />
    </div>
   </form>
    <div id="output2"></div>
</body>
</html>