表單處理是 Web 開發的核心場景。jQuery 提供了多種表單提交與資料序列化方式,從傳統的 .form('submit') 到現代的 AJAX 序列化,各有適用場景。本文將系統梳理三種主流模式,並提供生產級程式碼範例。
適用於 EasyUI 框架專案,支援驗證、提交前攔截、回調處理:
function addSubmit() {
$('#addForm').form('submit', {
url: _basePath + '/@Controller/@RequestMapping',
onSubmit: function() {
// 1. 自訂業務驗證
if (!businessCheck()) {
$.messager.show({ title:'提示', msg:'不符合儲存條件', showType:'fade' });
return false; // 阻止提交
}
// 2. EasyUI 內建 required 驗證
return $('#addForm').form('validate');
},
success: function(data) {
var obj = $.parseJSON(data); // 解析 JSON 回應
if (!obj.success) {
$.messager.show({ title:'提示', msg:'儲存失敗', showType:'fade' });
} else {
$.messager.show({ title:'提示', msg:'儲存成功', showType:'fade' });
$('#addWin').window('close');
query(); // 刷新列表
}
}
});
}
早期常見寫法,靈活但冗長:
$('#btn').click(function() {
$.get('get.php', {
username: $('#username').val(),
password: $('#password').val()
}, function(data, textStatus) {
$('#target').html(data);
});
});
核心優勢:自動收集表單所有欄位(含 checkbox、radio、select),自動 URL 編碼,一行搞定。
$('#btn').click(function() {
$.get('get.php', $('#form').serialize(), function(data, textStatus) {
$('#target').html(data);
});
});
回傳 [{name:'username', value:'john'}, {name:'pwd', value:'123'}] 格式,無需 parseJSON,可直接 $.each() 迭代:
var formData = $('#form').serializeArray();
$.each(formData, function(i, field) {
console.log(field.name + '=' + field.value);
});
// 通用 AJAX 表單提交
function submitForm(formId, url, successCallback) {
var $form = $('#' + formId);
if (!$form.form('validate')) return; // EasyUI 驗證
$.ajax({
url: url,
type: 'POST',
data: $form.serialize(), // 或 serializeArray()
dataType: 'json',
success: function(res) {
if (res.success) {
successCallback && successCallback(res);
} else {
showError(res.msg || '操作失敗');
}
},
error: function() { showError('網路異常'); }
});
}
// 使用範例
$('#saveBtn').click(function() {
submitForm('userForm', '/api/user/save', function(res) {
$('#userDlg').dialog('close');
$('#userGrid').datagrid('reload');
});
});
serialize() 不包含 disabled 的欄位 —— 若需提交隱藏 ID,請用 <input type="hidden"> 而非 disabledFormData + $.ajax({processData:false, contentType:false})現代專案建議以 serialize() / serializeArray() 搭配 $.ajax 為主,配合統一封裝提升開發效率;維護舊專案時才使用 .form('submit')。掌握序列化細節,讓表單處理不再是痛點。