DIV CSS 佈局教程網

用 jQuery serialize() 搭配 Ajax 快速批量送出表單資料
編輯:JQuery入門技巧     

表單欄位一多,逐個 $('#xxx').val() 取值不但冗長還容易漏。jQuery 提供的 serialize() 能把整個表單序列化成查詢字串,是處理這類場景最省事的做法。以下示範如何取出資料、轉成物件後用 Ajax 送出。

一、準備一個表單

<form id="fm">
<table>
  <tr><td>姓名</td><td><input type="text" name="name" /></td></tr>
  <tr><td>年齡</td><td><input type="text" name="age" /></td></tr>
  <tr><td>密碼</td><td><input type="password" name="password" /></td></tr>
  <tr>
    <td>性別</td>
    <td>
      <input type="radio" name="sex" value="male" />男
      <input type="radio" name="sex" value="female" />女
    </td>
  </tr>
  <tr>
    <td>地區</td>
    <td>
      <select name="area">
        <option value="heping">和平區</option>
        <option value="nankai">南開區</option>
        <option value="xiqing">西青區</option>
        <option value="hexi">河西區</option>
      </select>
    </td>
  </tr>
  <tr>
    <td>愛好</td>
    <td>
      <input type="checkbox" name="hobby[]" value="movie" />電影
      <input type="checkbox" name="hobby[]" value="music" />音樂
      <input type="checkbox" name="hobby[]" value="basketball" />籃球
    </td>
  </tr>
  <tr><td>個人介紹</td><td><textarea name="intro"></textarea></td></tr>
  <tr><td></td><td><input type="button" value="提交" id="submit" /></td></tr>
</table>
</form>

二、送出請求

自訂一個 getFormData() 把表單轉成物件,再丟給 $.post():

$(function(){
    $('#submit').click(function(){
        var form = $('#fm');
        var data = getFormData(form);   // 取得表單資料物件
        $.post('test.php', data, function(data){
            console.log('ok');
        });
    });
});

三、getFormData() 的實作

function getFormData(form){
    var data = form.serialize();      // a=1&b=2&c=3
    data = decodeURI(data);           // 還原被編碼的中文
    var arr = data.split('&');
    var item, key, value, newData = {};

    for (var i = 0; i < arr.length; i++){
        item  = arr[i].split('=');
        key   = item[0];
        value = item[1];

        if (key.indexOf('[]') != -1){       // 形如 hobby[] 的多選欄位
            key = key.replace('[]', '');
            if (!newData[key]) { newData[key] = []; }
            newData[key].push(value);
        } else {
            newData[key] = value;
        }
    }
    return newData;
}

四、後端收到的資料

test.php 接收到的陣列結構如下:

Array
(
    [name]     => 3241324
    [age]      => m_admin
    [password] => 123
    [sex]      => male
    [area]     => heping
    [hobby]    => Array
        (
            [0] => movie
            [1] => music
        )
    [intro]    => 321432423
)

幾點提醒

  • serialize() 只會收集有 name 屬性、且未被 disabled 的表單元素,這點與原生表單提交行為一致。
  • hobby[] 這種帶中括號的命名是 PHP 的慣例,會自動聚合為陣列;若後端是 Java 或 Node,建議改成 getParameterValues() 或自行約定分隔規則。
  • 若表單含檔案上傳,serialize() 無效,需改用 FormData 並搭配 processData: false、contentType: false。
  • 如果不想自己解析字串,也可以直接用 $('#fm').serializeArray() 拿到 key/value 陣列,再自行 reduce 成物件,程式碼更短。

希望這份整理對你的學習有所幫助。

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