DIV CSS 佈局教程網

JS 表單處理實戰:單選、多選、下拉框取值與表單序列化封裝
編輯:關於JavaScript     

表單取值看起來簡單,真正動手才會發現細節一堆:同名 radio 要回傳單一值、checkbox 要回傳多值、multiple 的 select 又是另一套邏輯,disabled 的欄位還不能送出去。本文把這些操作全部封裝成一個 formUtil 物件,順便加上表單序列化,之後專案直接拿去用即可。

var formUtil = {

  // 取得單選按鈕的值;沒有任何選項被勾選時回傳 null
  // elements 為同名 radio 集合的引用
  getRadioValue: function (elements) {
    var value = null;   // null 代表沒有選中項

    // 非 IE 瀏覽器:同名 radio 集合在部分實作下可直接取 value
    if (elements.value != undefined && elements.value != '') {
      value = elements.value;
    } else {
      // IE 需要逐一走訪
      for (var i = 0, len = elements.length; i < len; i++) {
        if (elements[i].checked) {
          value = elements[i].value;
          break;
        }
      }
    }
    return value;
  },

  // 取得多選按鈕的值;沒勾選時回傳 null
  // elements 為 checkbox 集合的引用
  getCheckboxValue: function (elements) {
    var arr = [];
    for (var i = 0, len = elements.length; i < len; i++) {
      if (elements[i].checked) {
        arr.push(elements[i].value);
      }
    }
    return arr.length > 0 ? arr.join(',') : null;
  },

  // 取得下拉框的值,同時處理單選與 multiple 複選
  getSelectValue: function (element) {
    if (element.selectedIndex == -1) {
      return null;   // 沒有任何選項被選
    }
    if (element.multiple) {
      var arr = [], options = element.options;
      for (var i = 0, len = options.length; i < len; i++) {
        if (options[i].selected) {
          arr.push(options[i].value);
        }
      }
      return arr.join(',');
    }
    return element.options[element.selectedIndex].value;
  },

  // 序列化:把整個表單轉成 query string 形式
  serialize: function (form) {
    var arr = [], elements = form.elements, checkboxName = null;

    for (var i = 0, len = elements.length; i < len; i++) {
      var field = elements[i];

      // 停用的欄位不送出
      if (field.disabled) continue;

      switch (field.type) {
        // 下拉選單
        case "select-one":
        case "select-multiple":
          arr.push(encodeURIComponent(field.name) + "=" + encodeURIComponent(this.getSelectValue(field)));
          break;

        // 這些類型不需要序列化
        case undefined:
        case "button":
        case "submit":
        case "reset":
        case "file":
          break;

        // checkbox:同名只需處理一次
        case "checkbox":
          if (checkboxName == null) {
            checkboxName = field.name;
            arr.push(encodeURIComponent(checkboxName) + "="
                   + encodeURIComponent(this.getCheckboxValue(form.elements[checkboxName])));
          }
          break;

        // radio:只送被選中的那一個
        case "radio":
          if (!field.checked) break;

        default:
          if (field.name.length > 0) {
            arr.push(encodeURIComponent(field.name) + "=" + encodeURIComponent(field.value));
          }
      }
    }
    return arr.join("&");
  }
};

搭配一個簡單的 Demo

<form action="test_php.php" id="form1" name="form1" method="post" enctype="multipart/form-data">
  姓名:<input name="name" type="text" tabindex="1" /><br>
  性別:<input name="sex" type="radio" value="男"/> 男
        <input name="sex" type="radio" value="女" /> 女<br>
  愛好:<input name="hobby" type="checkbox" value="籃球" /> 籃球
        <input name="hobby" type="checkbox" value="足球" /> 足球
        <input name="hobby" type="checkbox" value="乒乓球" /> 乒乓球
        <input name="hobby" type="checkbox" value="羽毛球" /> 羽毛球<br />
  年級:<select name="class" multiple>
          <option value="一年級">一年級</option>
          <option value="二年級">二年級</option>
          <option value="三年級">三年級</option>
        </select><br />
  其他:<br />
  <textarea name="other" rows="5" cols="30" tabindex="2"></textarea><br />
  <input type="reset" value="重置" />
  <input type="submit" value="提交" />
</form>
<div id="output"></div>
var form = document.getElementById("form1"),
    output = document.getElementById("output");

// 攔截 submit,改用自訂邏輯處理
EventUtil.addEventListener(form, "submit", function (event) {
  event = EventUtil.getEvent(event);
  EventUtil.preventDefault(event);

  var html = "";
  html += form.elements['name'].value + "<br>";
  html += formUtil.getRadioValue(form.elements['sex']) + "<br>";
  html += formUtil.getCheckboxValue(form.elements['hobby']) + "<br>";
  html += formUtil.getSelectValue(form.elements['class']) + "<br>";
  html += form.elements['other'].value + "<br>";
  html += decodeURIComponent(formUtil.serialize(form)) + "<br>";

  output.innerHTML = html;
});

使用上的幾個提醒

第一,getRadioValue 開頭那段「直接取 elements.value」的分支,是為了相容早期瀏覽器的實作差異;在現代瀏覽器裡,同名 radio 的集合本身確實帶有 value,但與其依賴這種行為,不如永遠走逐一走訪的分支,邏輯更明確也更好維護。

第二,序列化時務必對名稱與值都做一次 encodeURIComponent,否則遇到中文、&、= 這類字元就會把 query string 打壞。

第三,如果專案已經引入 jQuery,$('#form1').serialize() 一行就能完成同樣的事,而且處理得比手寫版本更嚴謹(例如 select multiple 全部未選時的正確行為)。手寫版本的價值在於理解底層規則,以及在没有框架的環境裡隨手可用。

以上就是這套表單取值與序列化的封裝,希望對大家的學習有幫助。

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