ajax() 方法通過 HTTP 要求載入遠端資料。
該方法是 jQuery 底層 AJAX 實現。簡單易用的高層實現見 $.get, $.post 等。$.ajax() 返回其建立的 XMLHttpRequest 對象。大多數情況下你無需直接操作該函數,除非你需要操作不常用的選項,以獲得更多的靈活性。
最簡單的情況下,$.ajax() 可以不帶任何參數直接使用。
注意:所有的選項都可以通過 $.ajaxSetup() 函數來全域設定
執行個體
代碼如下 |
複製代碼 |
$.ajax({ type:’post’,//可選get url:’action.php’,//這裡是接收資料的PHP程式 data:’data=’dsa”,//傳給PHP的資料,多個參數用&串連 dataType:’text’,//伺服器返回的資料類型 可選XML ,Json jsonp script html text等 success:function(msg){ //這裡是ajax提交成功後,PHP程式返回的資料處理函數。msg是返回的資料,資料類型在dataType參數裡定義! }, error:function(){ ajax提交失敗的處理函數! } }) PHP action.php <?php echo “www.111cn.net ”; ?> |
執行個體
通過 AJAX 載入一段文本:
代碼如下 |
複製代碼 |
jQuery 代碼: $(document).ready(function(){ $("#b01").click(function(){ htmlobj=$.ajax({url:"/jquery/test1.txt",async:false}); $("#myDiv").html(htmlobj.responseText); }); }); HTML 程式碼: <div id="myDiv"><h2>Let AJAX change this text</h2></div> <button id="b01" type="button">Change Content</button> |
執行個體
jQuery Ajax 事件
Ajax請求會產生若干不同的事件,我們可以訂閱這些事件並在其中處理我們的邏輯。在jQuery這裡有兩種Ajax事件:局部事件 和 全域事件。
局部事件就是在每次的Ajax請求時在方法內定義的,例如:
代碼如下 |
複製代碼 |
$.ajax({ beforeSend: function(){ // Handle the beforeSend event }, complete: function(){ // Handle the complete event } // ... });
|
全域事件是每次的Ajax請求都會觸發的,它會向DOM中的所有元素廣播,在上面 getScript() 樣本中載入的指令碼就是全域Ajax事件。全域事件可以如下定義:
代碼如下 |
複製代碼 |
$("#loading").bind("ajaxSend", function(){ $(this).show(); }).bind("ajaxComplete", function(){ $(this).hide(); }); 或者: $("#loading").ajaxStart(function(){ $(this).show(); }); |
我們可以在特定的請求將全域事件禁用,只要設定下 global 選項就可以了:
代碼如下 |
複製代碼 |
$.ajax({ url: "test.html", global: false,// 禁用全域Ajax事件. // ... }); |
參數名 |
類型 |
描述 |
url |
String |
(預設: 當前頁地址) 發送請求的地址。 |
type |
String |
(預設: "GET") 請求方式 ("POST" 或 "GET"), 預設為 "GET"。注意:其它 HTTP 要求方法,如 PUT 和 DELETE 也可以使用,但僅部分瀏覽器支援。 |
timeout |
Number |
佈建要求逾時時間(毫秒)。此設定將覆蓋全域設定。 |
async |
Boolean |
(預設: true) 預設設定下,所有請求均為非同步請求。如果需要發送同步請求,請將此選項設定為 false。注意,同步請求將鎖住瀏覽器,使用者其它操作必須等待請求完成才可以執行。 |
beforeSend |
Function |
發送請求前可修改 XMLHttpRequest 對象的函數,如添加自訂 HTTP 頭。XMLHttpRequest 對象是唯一的參數。 function (XMLHttpRequest) { this; // the options for this ajax request} |
cache |
Boolean |
(預設: true) jQuery 1.2 新功能,設定為 false 將不會從瀏覽器緩衝中載入請求資訊。 |
complete |
Function |
請求完成後回呼函數 (請求成功或失敗時均調用)。參數: XMLHttpRequest 對象,成功資訊字串。 function (XMLHttpRequest, textStatus) { this; // the options for this ajax request} |
contentType |
String |
(預設: "application/x-www-form-urlencoded") 發送資訊至伺服器時內容編碼類別型。預設值適合大多數應用場合。 |
data |
Object, String |
發送到伺服器的資料。將自動轉換為請求字串格式。GET 請求中將附加在 URL 後。查看 processData 選項說明以禁止此自動轉換。必須為 Key/Value 格式。如果為數組,jQuery 將自動為不同值對應同一個名稱。如 {foo:["bar1", "bar2"]} 轉換為 '&foo=bar1&foo=bar2'。 |
dataType |
String |
預期伺服器返回的資料類型。如果不指定,jQuery 將自動根據 HTTP 包 MIME 資訊返回 responseXML 或 responseText,並作為回呼函數參數傳遞,可用值: "xml": 返回 XML 文檔,可用 jQuery 處理。 "html": 返回純文字 HTML 資訊;包含 script 元素。 "script": 返回純文字 JavaScript 代碼。不會自動緩衝結果。 "json": 返回 JSON 資料 。 "jsonp": JSONP 格式。使用 JSONP 形式調用函數時,如 "myurl?callback=?" jQuery 將自動替換 ? 為正確的函數名,以執行回呼函數。 |
error |
Function |
(預設: 自動判斷 (xml 或 html)) 請求失敗時將調用此方法。這個方法有三個參數:XMLHttpRequest 對象,錯誤資訊,(可能)捕獲的錯誤對象。 function (XMLHttpRequest, textStatus, errorThrown) { // 通常情況下textStatus和errorThown只有其中一個有值 this; // the options for this ajax request} |
global |
Boolean |
(預設: true) 是否觸發全域 AJAX 事件。設定為 false 將不會觸發全域 AJAX 事件,如 ajaxStart 或 ajaxStop 。可用於控制不同的Ajax事件 |
ifModified |
Boolean |
(預設: false) 僅在伺服器資料改變時擷取新資料。使用 HTTP 包 Last-Modified 頭資訊判斷。 |
processData |
Boolean |
(預設: true) 預設情況下,發送的資料將被轉換為對象(技術上講並非字串) 以配合預設內容類型 "application/x-www-form-urlencoded"。如果要發送 DOM 樹資訊或其它不希望轉換的資訊,請設定為 false。 |
success |
Function |
請求成功後回呼函數。這個方法有兩個參數:伺服器返回資料,返回狀態 function (data, textStatus) { // data could be xmlDoc, jsonObj, html, text, etc... this; // the options for this ajax request} |
這裡有幾個Ajax事件參數:beforeSend ,success ,complete ,error 。我們可以定義這些事件來很好的處理我們的每一次的Ajax請求。注意一下,這些Ajax事件裡面的 this 都是指向Ajax請求的選項資訊的(請參考說 get() 方法時的this的圖片)。