表單提交有各種層次的做法,從完整交給框架,到逐欄取值,再到一行序列化。本文按演進順序整理,並說明每種方式的適用時機。
傳統表單的提交綁在 submit 按鈕上。透過 easyUI 的 form() 方法,可以把它綁到任何事件上,並在其中插入驗證與回饋邏輯:
function addSubmit() {
$('#addForm').form('submit', {
url: _basePath + '/@Controller/@RequestMapping',
onSubmit: function () {
if (boolean) { // 放置能否提交的判斷條件
$.messager.show({
title: '提示', msg: '不符合保存條件',
showType: 'fade', style: { right: '', bottom: '' }
});
return false; // 回傳 false 阻止表單提交
}
return $('#addForm').form('validate'); // 檢查 required 項是否都有值
},
success: function (data) {
var obj = jQuery.parseJSON(data); // 將回傳的 JSON 轉為物件
if (!obj.success) {
$.messager.show({
title: '提示', msg: '保存失敗',
showType: 'fade', style: { right: '', bottom: '' }
});
} else {
$.messager.show({
title: '提示', msg: '保存成功',
showType: 'fade', style: { right: '', bottom: '' }
});
$("#addWin").window("close"); // 關閉視窗
query(); // 重新查詢結果集
}
}
});
}
這個版本的優點是驗證、提示、關閉視窗、刷新列表全部包在一個設定物件裡,結構清楚。缺點是與 easyUI 深度耦合。
不用框架時,最直接的做法是從各欄位一一取值再組合成物件:
$("#btn").click(function () {
$.get("get.php", {
username: $("#username").val(),
password: $("#password").val()
}, function (data, textStatus) {
$("#target").html(data); // 將回傳值填入頁面
});
});
這種寫法清楚可控,但欄位一多就會變成長長一串,新增欄位時也容易漏改。
$("#btn").click(function () {
$.get("get.php", $("#form").serialize(), function (data, textStatus) {
$("#target").html(data);
});
});
serialize() 會把表單內容打包成 URL 查詢字串格式的標準字串,例如 username=amosli&age=30。它會自動進行 URL 編碼,處理特殊字元的問題;而且不限於表單元素,checkbox 等其他可提交元素也能正確處理。
serializeArray() 回傳的是陣列形式的物件,而非 JSON 字串:
var data = $("#form").serializeArray();
// [{ name: "username", value: "amosli" }, { name: "age", value: "30" }]
$.each(data, function (i, item) {
console.log(item.name + " = " + item.value);
});
因為回傳的已是真正的 JavaScript 物件,不必再呼叫 jQuery.parseJSON() 轉換,可以直接用 $.each() 等方法操作。若你需要對欄位做額外處理(例如過濾某些欄位、轉換值格式),這個形式比字串方便得多。
這個方法並非萬能,有幾個情況要注意:
只序列化成功的控制項。依 HTML 規範,未勾選的 checkbox 與 radio 不會被序列化、被 disabled 的欄位不會被序列化、沒有 name 屬性的欄位也不會。若後端需要收到「未勾選」的狀態,得另外處理。
file 上傳欄位不在其中。 serialize 產生的是字串,無法承載檔案,上傳必須改用 FormData。
jQuery 3.x 移除了部分舊語法。像 [@attr] 這種選擇器寫法已不適用,若維護舊程式碼需留意。
如今比較通用的做法有兩種。若只是要 traditional form-urlencoded 格式:
$("#btn").click(function (e) {
e.preventDefault();
$.ajax({
url: "get.php",
type: "POST",
data: $("#form").serialize(),
dataType: "json",
success: function (res) {
$("#target").html(res.message);
},
error: function () {
alert("網路異常,請稍後再試");
}
});
});
若需要支援檔案上傳,改用 FormData:
$("#btn").click(function (e) {
e.preventDefault();
var formData = new FormData(document.getElementById('myForm'));
$.ajax({
url: "upload.php",
type: "POST",
data: formData,
processData: false, // 關鍵:不要讓 jQuery 加工資料
contentType: false, // 關鍵:讓瀏覽器自動設定 multipart boundary
success: function (res) { console.log(res); }
});
});
processData: false 與 contentType: false 這兩個設定缺一不可。少了前者,jQuery 會把 FormData 轉成字串而失去檔案;少了後者,boundary 分隔符號會不正確而導致伺服器無法解析。
document.getElementById('myForm').addEventListener('submit', async function (e) {
e.preventDefault();
const formData = new FormData(this);
// 轉成普通物件(不含檔案時)
const payload = Object.fromEntries(formData.entries());
try {
const res = await fetch('/api/save', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify(payload)
});
if (!res.ok) throw new Error(res.statusText);
const data = await res.json();
console.log(data);
} catch (err) {
console.error('送出失敗:', err);
}
});
FormData 搭配 Object.fromEntries() 可以取代 serialize 的大部分用途,而且不依賴任何函式庫。若需要 JSON 格式給 RESTful API,這是最直接的寫法。