用 $('#form').serialize() 提交表單時,經常出現「明明填了值,後端卻收不到」的情況。原因通常就兩個:控件沒有 name,或者控件帶了 disabled。本文用四組對照實驗把規則講清楚。
而最關鍵的一條規則是:表單控件如果沒有 name 屬性,或者屬性帶有 disabled,那麼該字段不會被序列化,也不會出現在提交數據中。
<body>
<form id="form1">
<select>
<option value="0">葫蘆娃測試0</option>
<option value="1">葫蘆娃測試1</option>
<option value="2">葫蘆娃測試2</option>
</select>
<input type="button" id="btnSubmit" value="提交" name="btnSubmit" />
</form>
<script type="text/javascript">
$(document).ready(function () {
$('#btnSubmit').click(function () {
console.log('serialize:');
console.log($('#form1').serialize());
console.log('serializeArray:');
console.log($('#form1').serializeArray());
});
});
</script>
</body>
輸出結果:
serialize: serializeArray: [] length: 0

select 沒有 name,完全被忽略。注意 type="button" 的按鈕即使寫了 name 也不會被序列化——只有用於提交的控件才會被收集。
<body>
<form id="form1">
<select name="selectHuLuWa">
<option value="0">葫蘆娃測試0</option>
<option value="1">葫蘆娃測試1</option>
<option value="2">葫蘆娃測試2</option>
</select>
<input type="button" id="btnSubmit" value="提交" name="btnSubmit" />
</form>
<script type="text/javascript">
$(document).ready(function () {
$('#btnSubmit').click(function () {
console.log($('#form1').serialize());
console.log($('#form1').serializeArray());
});
});
</script>
</body>
輸出結果:
serialize: selectHuLuWa=0
serializeArray: [{ name: "selectHuLuWa", value: "0" }]

<select name="selectHuLuWa" readonly="readonly"> <option value="0">葫蘆娃測試0</option> <option value="1">葫蘆娃測試1</option> <option value="2">葫蘆娃測試2</option> </select>
測試結果:

有 name,值正常序列化。readonly 不影響提交。但要記住前面說的:readonly 對 select 根本無效,這個屬性寫上去等於沒寫。
<select name="selectHuLuWa" disabled="disabled"> <option value="0">葫蘆娃測試0</option> <option value="1">葫蘆娃測試1</option> <option value="2">葫蘆娃測試2</option> </select>
測試結果:

序列化結果為空。有 name 也沒用,disabled 的元素一律被排除。
四組實驗驗證了同一條規則:無 name 或帶 disabled 的控件無法被序列化。
那如果業務上確實需要「界面禁用但仍要提交值」怎麼辦?常見做法是在序列化前後臨時切換屬性:
function serializeWithDisabled(form) {
var $form = $(form);
// 序列化前:暫存被禁用的元素,然後解除禁用
var $disabled = $form.find(':disabled').prop('disabled', false);
// 序列化
var data = $form.serialize();
// 序列化後:恢復禁用狀態
$disabled.prop('disabled', true);
return data;
}
另一種更乾淨的方案是約定用 hidden 字段承載值:可見控件 disabled(不可編輯),同時維護一個同名或別名的 hidden input 存放實際值。這樣既不依賴臨時改 DOM,也不會出現序列化過程中界面閃一下的尷尬。
<input type="text" id="amountShow" value="100" disabled="disabled" /> <input type="hidden" name="amount" id="amount" value="100" />
還有一個相關的坑值得提:serialize() 只處理「成功的控件」,所以未勾選的 checkbox 和 radio 不會出現,沒有選項的 select multiple 也不會出現。如果後端需要區分「沒傳」和「傳了空值」,得在這些地方特別約定,或者改用 serializeArray() 拿到數組後自行補全。