DIV CSS 佈局教程網

jQuery Ajax post() 方法完整實解
編輯:AJAX基礎知識     

jQuery 的 ajax 家族裡,資料發送模式主要有兩種:get 與 post()。這篇專講 post()。

基本範例

請求 test.php,忽略回傳值:

$.post("test.php");

用 POST 請求改變 div 內容——輸入框每次 keyup 就送一次建議字:

$("input").keyup(function(){
  var txt = $("input").val();
  $.post("demo_ajax_gethint.asp", { suggest: txt }, function(result){
    $("span").html(result);
  });
});

定義與語法

post() 透過 HTTP POST 從伺服器載入資料。

jQuery.post(url, data, success(data, textStatus, jqXHR), dataType)

它等價於:

$.ajax({
  type: 'POST',
  url: url,
  data: data,
  success: success,
  dataType: dataType
});

依回應 MIME 型別不同,success 收到的資料可能是 XML 根元素、字串、JS 檔或 JSON 物件。jQuery 1.5 起,第三個參數改為 jqXHR 物件(1.4 是 XMLHttpRequest)。最常用的形式就是指定一個 success 函式:

$.post("ajax/test.html", function(data) {
  $(".result").html(data);
});

本例讀取被請求的 HTML 片段並插入頁面。

兩個重要提醒

第一,POST 回應預設不被快取,因此 $.ajaxSetup() 裡的 cache 與 ifModified 設定對這些請求不起作用。

第二,基於瀏覽器安全性限制,多數 Ajax 請求遵守同源政策——無法跨不同網域、子網域或協定取得資料。

第三,若請求回傳錯誤狀態碼,不會有任何提示,除非你另外設定了全域的 .ajaxError(),或使用 jqXHR 的 .error() 方法。

jqXHR 物件

從 jQuery 1.5 起,所有 Ajax 方法回傳的都是 XMLHttpRequest 的超集。$.post() 回傳的 jqXHR 實作了約定介面,並提供 .error()、.success()、.complete() 等方法,參數與對應命名的 $.ajax() 回呼一致。

這個介面還允許你為同一個請求串接多組回呼,甚至在請求已完成之後才掛上:

// 請求產生後立刻掛上處理器,記住回傳的是 jqXHR 物件
var jqxhr = $.post("example.php", function() {
  alert("success");
})
.success(function() { alert("second success"); })
.error(function()   { alert("error"); })
.complete(function(){ alert("complete"); });

// 在這裡做其他事

// 為同一個請求再補一個 complete 回呼
jqxhr.complete(function(){ alert("second complete"); });

更多實例

1. 帶額外參數、忽略回傳:

$.post("test.php", { name: "John", time: "2pm" });

2. 傳陣列:

$.post("test.php", { 'choices[]': ["Jon", "Susan"] });

3. 用 serialize() 送出整個表單:

$.post("test.php", $("#testform").serialize());

4. 印出回傳結果:

$.post("test.php", function(data){
  alert("Data Loaded: " + data);
});

5. 帶參數並印出結果:

$.post("test.php", { name: "John", time: "2pm" }, function(data){
  alert("Data Loaded: " + data);
});

6. 以 XML 形式處理:

$.post("test.php", { name: "John", time: "2pm" }, function(data){
  process(data);
}, "xml");

7. 取得 JSON 並取值:

$.post("test.php", { "func": "getNameAndTime" }, function(data){
  alert(data.name);       // John
  console.log(data.time); // 2pm
}, "json");

最後一個例子值得留意:明確宣告 dataType 為 "json",jQuery 會自動把字串解析成物件,這比自己在 success 裡 eval 安全得多。

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