標籤:工具 blog 文法 加工 data 包含 法語 oba content
AJAX請求 $.ajax方法的使用
使用jQuery的$.ajax方法可以更為詳細的控制AJAX請求。它在AJAX請求上施加細粒度層級的控制。
$.ajax方法文法
$.ajax(options) |
參數 |
|
options |
(對象)一個對象的執行個體,其屬性定義這個操作的參數。詳情見下表。 |
傳回值 |
XHR執行個體 |
options詳細範圍值
名稱 |
類型 |
描述 |
url |
字串 |
請求的url地址 |
type |
字串 |
將要使用的HTTP方法。通常是POST或GET。如果省略,則預設為GET |
data |
對象 |
一個對象,其屬性作為查詢參數而傳遞請求。如果是GET請求,則把資料作為查詢字串傳遞;如果是POST請求,則把資料作為請求體傳遞。在這兩種情況下,都是由$.ajax()工具 + 生產力函數來處理值的編碼 |
dataType |
字串 |
一個關鍵字,用來標識預期將被響應所返回的資料的類型。這個值決定再把資料傳遞給回呼函數之前(如果有)進行什麼後續處理。有效值如下: xml-響應文本被解析為XML文檔,而作為結果的XML DOM被傳遞給回呼函數 html-響應文本未經處理就被傳遞給回呼函數。在已返回HTML片段內的任何<script>塊將被求值 json-響應文本被求值為JSON字串,而作為結果的對象被傳遞給回呼函數 jsonp-與json相似,不同之處是提供遠程指令碼支援(假定遠程伺服器支援) script-響應文本被傳遞給回呼函數。在任何回呼函數被調用之前,響應被作為一個或多個JavaScript語句而進行處理 text-響應文本被假定為普通文本。伺服器資源負責設定適當的內容類型響應標題。如果省略這個屬性,則不對響應文本進行任何處理或求值就傳遞給回呼函數 |
timeout |
數值 |
設定Ajax請求的逾時值(毫秒)。如果請求在逾時值到期之前仍未完成,則中止請求並且調用錯誤回呼函數(如果已定義) |
global |
布爾型 |
啟用或禁用全域函數的觸發。這些函數可以附加到元素上,並且在Ajax調用的不同時刻或狀態下觸發。預設啟用全域函數觸發 |
contentType |
字串 |
將要在請求上指定的內容類型。預設為application/x-www-form-urlencoded(與表單提交所使用的預設類型相同) |
success |
函數 |
如果請求的響應指示成功狀態代碼,則這個函數被調用。響應體作為第一個參數被返回給這個函數,並且根據指定的dataType屬性進行。第二個參數是包含狀態代碼的字串—這種情況下永遠為成功狀態代碼 |
error |
函數 |
如果請求的響應返回錯誤狀態代碼,則這個函數被調用。三個實參被傳遞給這個函數:XHR執行個體、狀態訊息字串(在這種情況下永遠為錯誤狀態代碼)以及XHR執行個體所返回的異常對象(可選) |
complete |
函數 |
請求完成時被調用。兩個實參被傳遞:XHR執行個體和狀態訊息字串(成功狀態代碼或錯誤狀態代碼)。如果也指定了success或error回呼函數,則這個函數在success或error回呼函數調用之後被調用 |
beforeSend |
函數 |
在發起請求之前被調用。這個函數被傳遞XHR執行個體,並且可以用來設定自訂的標題或執行其他預請求操作 |
async |
布爾型 |
如果指定為false,則請求被提交為同步請求。在預設的情況下,請求是非同步 |
processData |
布爾型 |
如果設定為false,則阻止已傳遞資料被加工為URL編碼格式。預設情況下,資料被加工為URL編碼格式(適用於類型為application/x-www-form-urlencoded的請求) |
ifModified |
布爾型 |
如果設定為true,則自從上一次請求以來,只有在響應內容沒有改變的情況下(根據Last-Modified標題)才允許請求成功。如果省略,則不執行標題檢查 |
AJAX請求 $.ajax方法的使用