DIV CSS 佈局教程網

用 jQuery $.ajax 提交表單:data 參數的兩種寫法與雷區
編輯:JQuery特效代碼     

以 ajax 送出一份表單資料,是前端最日常的任務之一。以下先還原一個典型的提交函數:

function postdata(){
  $.ajax({
    type: "POST",                        // 指定提交方式
    url: "ok.php",                       // 提交到 ok.php
    data: "writer=" + $("#writer").val(),// 以輸入框的值作為提交內容
    success: function(msg){              // msg 為 ok.php 輸出的內容
      alert("數據提交成功");
      // 如有需要,可把 msg 顯示到某個 DIV 中
    }
  });
}

jQuery 手冊對 data 的說明是:傳送到伺服器的資料,會自動轉為請求字串格式;GET 請求時會附加在 URL 之後。它必須是 key/value 形式,若為陣列,jQuery 會自動把多個值對應到同一個名稱,例如 {foo:["bar1","bar2"]} 會轉成 &foo=bar1&foo=bar2。若要停用這個自動轉換,可改用 processData 選項。

官方範例:

$.ajax({
  type: "POST",
  url: "some.php",
  data: "name=John&location=Boston",
  success: function(msg){
    alert("Data Saved: " + msg);
  }
});

兩種寫法,差別在哪?

實務上 data 有兩種常見形式:

// 寫法一:字串,形同一般 URL 傳參數
data: "name=John&location=Boston"

// 寫法二:物件字面量
data: {name: "John", location: "Boston"}

兩者看似等價,實際使用上卻有一個容易踩到的差異。

雷區:參數值裡含有 &

採字串寫法時,如果值本身帶有 & 符號,後端很可能收到被截斷的內容。舉例來說,若 name 的值是 john&smith,直接拼成字串就會讓伺服器誤判成兩個參數。

解法是先用 encodeURIComponent() 做 URL 編碼:

data: "name=" + encodeURIComponent("john&smith")

但如果改用物件寫法,jQuery 會自行處理編碼,不需要手動轉義;反過來說,若你在物件寫法裡又多做一次轉義,伺服器收到的就會是被編碼後的字串,反而出錯。

結論

兩種寫法都能用,但物件形式更省心:不必自己拼字串、不必記得編碼、可讀性也更好。除非有特殊需求(例如要組出特定格式的參數),否則建議優先採用 data: {key: value}。

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