以 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}。