jquery ajax 方法及各參數詳解。本站提示廣大學習愛好者:(jquery ajax 方法及各參數詳解)文章只能為提供參考,不一定能成為您想要的結果。以下是jquery ajax 方法及各參數詳解正文
1.$.ajax() 只有一個參數:參數 key/value 對象,包含各配置及回調函數信息。
參數列表:
參數名 類型 描述 url String (默認: 當前頁地址) 發送請求的地址。 type String (默認: "GET") 請求方式 ("POST" 或 "GET"), 默認為 "GET"。注意:其它 HTTP 請求方法,如 PUT 和 DELETE 也可以使用,但僅部分浏覽器支持。 timeout Number 設置請求超時時間(毫秒)。此設置將覆蓋全局設置。 async Boolean (默認: true) 默認設置下,所有請求均為異步請求。如果需要發送同步請求,請將此選項設置為 false。注意,同步請求將鎖住浏覽器,用戶其它操作必須等待請求完成才可以執行。 beforeSend Function 發送請求前可修改 XMLHttpRequest 對象的函數,如添加自定義 HTTP 頭。XMLHttpRequest 對象是唯一的參數。function (XMLHttpRequest) {cache Boolean (默認: true) jQuery 1.2 新功能,設置為 false 將不會從浏覽器緩存中加載請求信息。 complete Function 請求完成後回調函數 (請求成功或失敗時均調用)。參數: XMLHttpRequest 對象,成功信息字符串。
this; // the options for this ajax request }
function (XMLHttpRequest, textStatus) {contentType String
this; // the options for this ajax request }
(默認: "application/x-www-form-urlencoded") 發送信息至服務器時內容編碼類型。默認值適合大多數應用場合。告訴服務器從浏覽器提交過來的數據格式。
例如:我們提交數據時假如使用了 JSON2.js 中方法 JSON.stringify(obj) 格式化為json字符串後,再默認提交就會報錯。這個時候就需要指定提交的內容格式為:"application/json"。
data Object,發送到服務器的數據。
若data數據類型為JavaScript對象或數組,Jquery在提交之前自動調用JQuery.param()方法把要發送的數據編碼成為"application/x-www-form-urlencoded"格式的數據(即 name=value&name1=value1);JavaScript對象必須為 Key/Value 格式;如果為數組,jQuery 將自動為不同值對應同一個名稱。如 {foo:["bar1", "bar2"]} 轉換為 '&foo=bar1&foo=bar2';
若data數據類型為String類型,則直接默認該數據已經按照"application/x-www-form-urlencoded"格式編碼完成,不再轉換。
processData選項可以控制是否進行轉換。該選項默認為true。
dataType String預期服務器返回的數據類型。設定HttpHeader中“Accept”域的內容,告訴服務器浏覽器可以想要返回的數據格式類型,同時JQuery也會根據該類型對返回的數據進行處理。如果不指定,jQuery 將自動根據 HTTP 包 MIME 信息返回 responseXML 或 responseText,並作為回調函數參數傳遞,可用值:
"xml": 返回 XML 文檔,可用 jQuery 處理。
"html": 返回純文本 HTML 信息;包含 script 元素。
"script": 返回純文本 JavaScript 代碼。不會自動緩存結果。
"json": 返回 JSON 數據 。JQuery將返回的字符串格式數據自動轉化為Javascript對象,便於直接使用obj.property格式訪問。若沒有指定該選項,即使返回的是JSON格式的字符串,JQuery也不會自動轉換。
"jsonp": JSONP 格式。使用 JSONP 形式調用函數時,如 "myurl?callback=?" jQuery 將自動替換 ? 為正確的函數名,以執行回調函數。
error Function (默認: 自動判斷 (xml 或 html)) 請求失敗時將調用此方法。這個方法有三個參數:XMLHttpRequest 對象,錯誤信息,(可能)捕獲的錯誤對象。function (XMLHttpRequest, textStatus, errorThrown) {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 請求成功後回調函數。這個方法有兩個參數:服務器返回數據,返回狀態
// 通常情況下textStatus和errorThown只有其中一個有值 this; // the options for this ajax request }
function (data, textStatus) {
// data could be xmlDoc, jsonObj, html, text, etc... this; // the options for this ajax request }
2. jQuery.get(url, [data], [callback], [type]):使用GET方式來進行異步請求.
參數:
url (String) : 發送請求的URL地址.
data (Map) : (可選) 要發送給服務器的數據,以 Key/value 的鍵值對形式表示。
callback (Function) : (可選) 載入成功時回調函數(只有當Response的返回狀態是success才是調用該方法)。
type (String) : (可選)官方的說明是:Type of data to be sent。其實應該為客戶端請求的類型(JSON,XML,等等)
3. jQuery.post( url, [data], [callback], [type] ) :使用POST方式來進行異步請求
參數:
url (String) : 發送請求的URL地址.
data (Map) : (可選) 要發送給服務器的數據,以 Key/value 的鍵值對形式表示。
callback (Function) : (可選) 載入成功時回調函數(只有當Response的返回狀態是success才是調用該方法)。
type (String) : (可選)官方的說明是:Type of data to be sent。其實應該為客戶端請求的類型(JSON,XML,等等)