DIV CSS 佈局教程網

jQuery 表單序列化踩坑指南:name、readonly 與 disabled 的區別
編輯:JQuery入門技巧     

用 $('#form').serialize() 提交表單時,經常出現「明明填了值,後端卻收不到」的情況。原因通常就兩個:控件沒有 name,或者控件帶了 disabled。本文用四組對照實驗把規則講清楚。

先說 readonly 和 disabled 的本質差異

  • readonly:只對 input 和 textarea 有效,select 上寫了也不起作用。元素仍可以獲得焦點,只是不能修改內容。
  • disabled:對所有表單元素都有效,包括 input、select、textarea、checkbox、radio、button。元素無法獲得焦點,也不會隨表單提交。

而最關鍵的一條規則是:表單控件如果沒有 name 屬性,或者屬性帶有 disabled,那麼該字段不會被序列化,也不會出現在提交數據中。

實驗一:沒有設置 name

<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 也不會被序列化——只有用於提交的控件才會被收集。

實驗二:加上 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" }]

實驗三:加上 readonly

<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 根本無效,這個屬性寫上去等於沒寫。

實驗四:加上 disabled

<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() 拿到數組後自行補全。

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