jQuery Form Plugin 讓表單以 AJAX 方式提交變得極簡單,核心提供兩個方法:
ajaxForm(options):綁定表單 submit 事件,自動攔截並 AJAX 提交。ajaxSubmit(options):手動觸發 AJAX 提交,適合按鈕非 type="submit" 或需額外驗證邏輯。<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>jQuery Form Plugin Demo</title>
<script src="https://code.jquery.com/jquery-1.12.4.min.js"></script>
<script src="https://cdnjs.cloudflare.com/ajax/libs/jquery.form/4.3.0/jquery.form.min.js"></script>
</head>
<body>
<h3>方式一:ajaxForm 自動綁定</h3>
<form id="form1" action="chuli.php" method="post">
<input name="name" placeholder="姓名">
<input name="sex" placeholder="性別">
<button type="submit">提交</button>
</form>
<h3>方式二:ajaxSubmit 手動觸發</h3>
<form id="form2" action="chuli.php" method="post">
<input name="name" placeholder="姓名">
<input name="sex" placeholder="性別">
<button type="button" id="btnSubmit">提交</button>
</form>
<script>
// ajaxForm:宣告式選項
$('#form1').ajaxForm({
dataType: 'json',
beforeSubmit: function(arr, $form, opts) {
console.log('form1 送出前', arr);
return true; // 回傳 false 可取消提交
},
success: function(data, status, xhr, $form) {
alert('form1 成功:' + JSON.stringify(data));
},
error: function(xhr, status, err) {
alert('form1 失敗:' + err);
},
clearForm: true,
resetForm: true
});
// ajaxSubmit:命令式呼叫
$('#btnSubmit').click(function() {
$('#form2').ajaxSubmit({
dataType: 'json',
success: function(data) {
alert('form2 成功:' + JSON.stringify(data));
},
error: function(xhr, status, err) {
alert('form2 失敗:' + err);
}
});
});
</script>
</body>
</html>
| 選項 | 型別 | 預設 | 說明 |
|---|---|---|---|
| url | String | form.action | 提交目標網址 |
| type / method | String | form.method | HTTP 方法 GET/POST |
| dataType | String | 'auto' | 預期回傳格式:json, xml, script, html, text |
| beforeSubmit | Function | null | 提交前回調,回傳 false 取消 |
| success | Function | null | 成功回調 (data, status, xhr, $form) |
| error | Function | null | 失敗回調 (xhr, status, error) |
| complete | Function | null | 完成回調(成功/失敗皆執行) |
| clearForm | Boolean | false | 成功後清空表單輸入值 |
| resetForm | Boolean | false | 成功後重置表單至初始狀態 |
| iframe | Boolean | false | 檔案上傳時設 true(內部用隱藏 iframe 模擬 AJAX) |
| forceSync | Boolean | false | 強制同步模式(不建議) |
$('#uploadForm').ajaxSubmit({
dataType: 'json',
iframe: true, // 必須啟用
// 或使用 FormData (現代瀏覽器)
// processData: false,
// contentType: false,
success: function(res) { console.log(res); }
});
beforeSubmit 整合 jQuery Validation:return $form.valid();uploadProgress 事件(需瀏覽器支援 XHR2)。<input type="file" name="files[]" multiple>,後端接收陣列。xhr 物件(beforeSerialize 或 beforeSubmit 回調中取得),稍後呼叫 xhr.abort()。