jQuery ajax() 方法

jQuery AJAX 方法 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 對象的函數。

實例

更多實例

生成非同步 AJAX 請求
如何使用非同步設置來規定非同步請求。

生成帶有指定數據類型的 AJAX 請求
如何使用 dataType 設置來規定請求的數據類型。

生成帶有錯誤的 AJAX 請求
如何使用錯誤設置來處理 AJAX 請求中的錯誤。

jQuery AJAX 方法 jQuery AJAX 方法