jQuery ajax() 方法
示例
使用 AJAX 請求更改 <div> 元素的文字
$("button").click(function(){
$.ajax({url: "demo_test.txt", success: function(result){
$("#div1").html(result);
}});
});
自己動手試一試 »
定義和用法
ajax() 方法用於執行 AJAX(非同步 HTTP)請求。
所有 jQuery AJAX 方法都使用 ajax() 方法。當其他方法無法使用時,此方法通常用於請求。
語法
$.ajax({name:value, name:value, ... })
引數指定 AJAX 請求的一個或多個名稱/值對。
下表中的可能名稱/值
名稱 | 值/描述 |
---|---|
async | 一個布林值,指示請求是應非同步處理還是同步處理。預設為 true |
beforeSend(xhr) | 在傳送請求之前執行的函式 |
cache | 一個布林值,指示瀏覽器是否應快取請求的頁面。預設為 true |
complete(xhr,status) | 請求完成時執行的函式(在 success 和 error 函式之後) |
contentType | 將資料傳送到伺服器時使用的內容型別。預設為:“application/x-www-form-urlencoded” |
context | 為所有 AJAX 回撥函式指定“this”值 |
data | 指定要傳送到伺服器的資料 |
dataFilter(data,type) | 用於處理 XMLHttpRequest 的原始響應資料的函式 |
dataType | 伺服器響應期望的資料型別。 |
error(xhr,status,error) | 如果請求失敗,則執行的函式。 |
global | 一個布林值,指定是否為請求觸發全域性 AJAX 事件處理程式。預設為 true |
ifModified | 一個布林值,指定請求是否僅在上次請求後響應已更改時才成功。預設為:false。 |
jsonp | 一個字串,用於覆蓋 jsonp 請求中的回撥函式 |
jsonpCallback | 為 jsonp 請求中的回撥函式指定名稱 |
password | 指定用於 HTTP 訪問身份驗證請求的密碼。 |
processData | 一個布林值,指定傳送到請求的資料是否應轉換為查詢字串。預設為 true |
scriptCharset | 指定請求的字元集 |
success(result,status,xhr) | 請求成功時執行的函式 |
timeout | 請求的本地超時(以毫秒為單位) |
traditional | 一個布林值,指定是否使用引數序列化的傳統樣式 |
type | 指定請求型別。(GET 或 POST) |
url | 指定傳送請求的 URL。預設為當前頁面 |
username | 指定用於 HTTP 訪問身份驗證請求的使用者名稱 |
xhr | 用於建立 XMLHttpRequest 物件的函式 |
親手嘗試 - 示例
使用 async 設定
如何使用 async 設定指定同步請求
使用指定的資料型別發出 AJAX 請求
如何使用 dataType 設定為請求指定資料型別。
發出帶有錯誤的 AJAX 請求
如何使用 error 設定來處理 AJAX 請求中的錯誤。