DIV CSS 佈局教程網

用 jQuery Form 外掛以 Ajax 提交表單的完整指南
編輯:關於JavaScript     

傳統的表單提交會讓整個頁面刷新一次,使用者看不到過程,也不知道到底成功了沒。改成 Ajax 之後,就能明確回饋「正在提交」「提交成功」這些狀態。jQuery Form 外掛把這件事簡化到只需呼叫一個方法。

這個外掛帶來的好處

支援提交前的驗證、支援提交後的回呼;以 Ajax 傳輸,互動體驗自然更好;提交方式相當自由,只要指定 form 的 id 就能決定要送哪一份表單,參數也可另行設定;同時支援 xml、json 等多種回應型別。

主要方法逐一說明

ajaxForm

為 Ajax 提交做好準備:掛上所有必要的事件監聽器。它不負責送出表單,通常在 document.ready 中呼叫。可帶入 0 或 1 個參數,這個參數可以是回呼函式,也可以是 options 物件。

$('#myFormId').ajaxForm();

ajaxSubmit

立刻以 Ajax 送出表單,多數情況是在 submit 事件裡呼叫它。

//綁定表單提交事件處理器
$('#myFormId').submit(function() {
    //提交表單
    $(this).ajaxSubmit();
    //回傳 false 以阻止瀏覽器預設的表單送出與頁面跳轉
    return false;
});

formSerialize

把整份表單序列化成查詢字串,格式為 name1=value1&name2=value2,回傳字串。

var queryString = $('#myFormId').formSerialize();
//接著就能用 $.get、$.post、$.ajax 送出
$.post('myscript.php', queryString);

fieldSerialize

只序列化部分欄位,當你只想送出特定區域的資料時很方便,回傳格式同上。

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

fieldValue

回傳符合條件的表單元素值,自 0.91 版起一律以陣列形式回傳;若判定值可能無效則回傳空陣列,否則含一個或多個元素值。

//取得密碼欄位的值
var value = $('#myFormId :password').fieldValue();
alert('The password is: ' + value[0]);

resetForm

呼叫表單元素原有的 DOM 方法,把表單還原到初始狀態。

$('#myFormId').resetForm();

clearForm

清空欄位:文字輸入、密碼輸入與 textarea 被設為空字串,select 的選定被清除,radio 與 checkbox 全部回到未選定狀態。

$('#myFormId').clearForm();

clearFields

只清空部分欄位時使用。

$('#myFormId .specialFields').clearFields();

一個可直接跑的完整示例

<%@ 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">
$(document).ready(function() {
    //為 myForm 掛上 ajaxForm 並提供回呼
    $('#myForm').ajaxForm(function() {
        alert("Thank you for your comment!");
    });
});

//表單的 submit 事件
$('#myFormId').submit(function() {
    $(this).ajaxSubmit();
    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>

這裡有個常見的混淆點值得提醒:範例中的表單 id 是 myForm,而 submit 事件卻選在 #myFormId 上,兩者不一致時 submit 的處理器根本不會觸發。實作時把選擇器統一即可。另外,ajaxForm 與 ajaxSubmit 沒有必要同時使用——前者是「預先掛好、送出時自動走 Ajax」,後者是「需要時才主動送出」,選一種就好。

以上就是本文對 jQuery 透過 jQuery.form.js 外掛以 Ajax 提交表單的整理,希望對你有幫助。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved