jQuery.ajax(options)
通過 HTTP 請求加載遠程數據。jQuery 底層 AJAX 實現。簡單易用的高層實現見 .get,.post 等。
.ajax()返回其創建的XMLHttpRequest對象。大多數情況下你無需直接操作該對象,但特殊情況下可用于手動終止請求。.ajax() 只有一個參數:參數 key/value 對象,包含各配置及回調函數信息。詳細參數選項見下。
注意: 如果你指定了 dataType 選項,請確保服務器返回正確的 MIME 信息,(如 xml 返回 "text/xml")。錯誤的 MIME 類型可能導致不可預知的錯誤。
注意:如果dataType設置為"script",那么在遠程請求時(不在同一個域下),所有POST請求都將轉為GET請求。(因為將使用DOM的script標簽來加載)
jQuery 1.2 中,您可以跨域加載 JSON 數據,使用時需將數據類型設置為 JSONP。使用 JSONP 形式調用函數時,如 "myurl?callback=?" jQuery 將自動替換 ? 為正確的函數名,以執行回調函數。數據類型設置為 "jsonp" 時,jQuery 將自動調用回調函數。
返回值 XMLHttpRequest
參數
options (可選) : AJAX 請求設置。所有選項都是可選的。
選項
(1)、async (Boolean) : (默認: true)
默認設置下,所有請求均為異步請求。如果需要發送同步請求,請將此選項設置為 false。注意,同步請求將鎖住瀏覽器,用戶其它操作必須等待請求完成才可以執行。
(2)beforeSend (Function) : 發送請求前可修改 XMLHttpRequest 對象的函數,如添加自定義 HTTP 頭。
XMLHttpRequest 對象是唯一的參數。這是一個 Ajax 事件。如果返回false可以取消本次ajax請求。
(3)、cache (Boolean) : (默認: true,dataType為script時默認為false)
jQuery 1.2 新功能,設置為 false 將不會從瀏覽器緩存中加載請求信息。
(4)、complete (Function) : 請求完成后回調函數 (請求成功或失敗時均調用)。
參數: XMLHttpRequest 對象和一個描述成功請求類型的字符串。 這是一個 Ajax 事件
(5)、contentType (String) : (默認: "application/x-www-form-urlencoded") 發送信息至服務器時內容編碼類型。默認值適合大多數應用場合。
(6)、data (Object,String) : 發送到服務器的數據。將自動轉換為請求字符串格式。GET 請求中將附加在URL 后。查看processData選項說明以禁止此自動轉換。
必須為 Key/Value 格式。如果為數組,jQuery 將自動為不同值對應同一個名稱。如 {foo:["bar1", "bar2"]} 轉換為 '&foo=bar1&foo=bar2'。
(7)、dataFilter (Function) :給Ajax返回的原始數據的進行預處理的函數。提供data和type兩個參數:data是Ajax返回的原始數據,type是調用jQuery.ajax時提供的dataType參數。函數返回的值將由jQuery進一步處理。
(8)、dataType (String) : (默認值:智能判斷xml或者html)
預期服務器返回的數據類型。如果不指定,jQuery 將自動根據 HTTP 包 MIME 信息返回responseXML 或 responseText,并作為回調函數參數傳遞,可用值:
"xml": 返回 XML 文檔,可用 jQuery 處理。
"html": 返回純文本 HTML 信息;包含的script標簽會在插入dom時執行。
"script": 返回純文本 JavaScript 代碼。不會自動緩存結果。除非設置了"cache"參數。注意:在遠程請求時(不在同一個域下),所有POST請求都將轉為GET請求。(因為將使用DOM的script標簽來加載)
"json": 返回 JSON 數據 。
"jsonp": JSONP 格式。使用 JSONP 形式調用函數時,如 "myurl?callback=?" jQuery 將自動替換 ? 為正確的函數名,以執行回調函數。
"text": 返回純文本字符串
(9)、error (Function) : (默認: 自動判斷 (xml 或 html)) 請求失敗時調用時間。參數有以下三個:XMLHttpRequest 對象、錯誤信息、(可選)捕獲的錯誤對象。如果發生了錯誤,錯誤信息(第二個參數)除了得到null之外,還可能是"timeout", "error", "notmodified" 和 "parsererror"。Ajax 事件。
(10)、global (Boolean) : (默認: true) 是否觸發全局 AJAX 事件。設置為 false 將不會觸發全局 AJAX 事件,如 ajaxStart 或 ajaxStop 可用于控制不同的 Ajax 事件。
(11)、ifModified (Boolean) : (默認: false) 僅在服務器數據改變時獲取新數據。使用 HTTP 包 Last-Modified 頭信息判斷。
(12)、jsonp (String) : 在一個jsonp請求中重寫回調函數的名字。這個值用來替代在"callback=?"這種GET或POST請求中URL參數里的"callback"部分,比如{jsonp:'onJsonPLoad'}會導致將"onJsonPLoad=?"傳給服務器。
(13)、password (String) : 用于響應HTTP訪問認證請求的密碼
(14)、processData (Boolean) : (默認: true) 默認情況下,發送的數據將被轉換為對象(技術上講并非字符串) 以配合默認內容類型 "application/x-www-form-urlencoded"。如果要發送 DOM 樹信息或其它不希望轉換的信息,請設置為 false。
(15)、scriptCharset (String) : 只有當請求時dataType為"jsonp"或"script",并且type是"GET"才會用于強制修改charset。通常在本地和遠程的內容編碼不同時使用。
(16)、success (Function) : 請求成功后的回調函數。參數:由服務器返回,并根據dataType參數進行處理后的數據;描述狀態的字符串。 Ajax 事件。
(17)、timeout (Number) : 設置請求超時時間(毫秒)。此設置將覆蓋全局設置。
(18)、type (String) : (默認: "GET") 請求方式 ("POST" 或 "GET"), 默認為 "GET"。注意:其它 HTTP 請求方法,如 PUT 和 DELETE 也可以使用,但僅部分瀏覽器支持。
(19)、url (String) : (默認: 當前頁地址) 發送請求的地址。
(20)、username (String) : 用于響應HTTP訪問認證請求的用戶名
(21)、xhr (Function) : 需要返回一個XMLHttpRequest 對象。默認在IE下是ActiveXObject 而其他情況下是XMLHttpRequest 。用于重寫或者提供一個增強的XMLHttpRequest 對象。這個參數在jQuery 1.3以前不可用。
使用jQuery.ajax()方法獲取數據,代碼如下:
$.ajax({ url: "http://www.gxlcms.com", //請求的url地址 dataType: "json", //返回格式為json async: true, //請求是否異步,默認為異步,這也是ajax重要特性 data: { "id": "value" }, //參數值 type: "GET", //請求方式 beforeSend: function() { //請求前的處理 }, success: function(req) { //請求成功時處理 }, complete: function() { //請求完成的處理 }, error: function() { //請求出錯處理 } });
聲明:本網頁內容旨在傳播知識,若有侵權等問題請及時與本網聯系,我們將在第一時間刪除處理。TEL:177 7030 7066 E-MAIL:11247931@qq.com