全局 Ajax 事件處理器

全局 Ajax 事件處理器

這些方法用於註冊事件處理器,用來處理頁面上的任何 Ajax 請求,當某些事件觸發後,這些事件處理器被調用。如果 jQuery.ajaxSetup() 中的 global 屬性被設置爲 true (這也是默認設置),那麼,每個 Ajax 請求都會觸發全局事件。
注意: 全局事件絕對不會被跨域(cross-domain)腳本或 JSONP 請求觸發,和 global 屬性的設置毫無關係。


一、.ajaxStart()

描述: 在AJAX 請求剛開始時執行一個處理函數。 這是一個 Ajax Event.

參數
.ajaxStart(callback)

  • callback: 類型: Function()被調用的函數。

每當一個Ajax請求即將發送,jQuery檢查是否有任何其他響應過程中的Ajax請求(注:未完成的請求)。如果沒有檢查到,jQuery就會觸發ajaxStart事件,在這個時間點所有處理函數都會使用.ajaxStart()方法註冊並執行。

注意

  • 從 jQuery 1.8 開始, .ajaxStart() 方法只能綁定到 document元素.

二、.ajaxSend()

描述: 在Ajax請求發送之前綁定一個要執行的函數,這是一個 Ajax Event.
XMLHttpRequest 對象和設置作爲參數傳遞給回調函數。

參數
ajaxSend(fn(event, jqXHR, ajaxOptions))

  • fn(event, jqXHR, ajaxOptions):類型: Function()被調用的函數。

每當一個Ajax請求即將發送,jQuery就會觸發ajaxSend事件,在這個時間點所有處理函數都會使用.ajaxSend()方法註冊並執行。

注意

  • 從 jQuery 1.8 開始, .ajaxSend() 方法只能綁定到 document元素.
  • 如果global選項設置爲false,調用$.ajax() 或 .ajaxSend()方法將不會被觸發。

三、.ajaxComplete()

描述: 當Ajax請求完成後註冊一個回調函數。這是一個 Ajax Event.
XMLHttpRequest 對象和設置作爲參數傳遞給回調函數。

參數
ajaxComplete(fn(event, XMLHttpRequest, ajaxOptions))

  • fn(event, XMLHttpRequest, ajaxOptions):類型: Function()被調用的函數。

每當一個Ajax請求完成,jQuery就會觸發ajaxComplete事件,在這個時間點所有處理函數會使用.ajaxComplete()方法註冊並執行。

注意

  • 從 jQuery 1.8 開始, .ajaxComplete() 方法只能綁定到 document元素.
  • 如果global選項設置爲false,調用$.ajax() 或 $.ajaxSetup(),.ajaxComplete()方法將不會被觸發。

四、.ajaxSuccess()

描述: 綁定一個函數當 Ajax 請求成功完成時執行。,這是一個 Ajax Event.
XMLHttpRequest 對象和設置作爲參數傳遞給回調函數。

參數
ajaxSuccess(fn(event, XMLHttpRequest, ajaxOptions))

  • fn(event, XMLHttpRequest, ajaxOptions):類型: Function()被調用的函數。

每當一個Ajax請求成功完成,jQuery就會觸發ajaxSuccess事件,在這個時間點所有處理函數都會使用.ajaxSuccess()方法註冊並執行。

注意

  • 從 jQuery 1.8 開始, .ajaxSuccess() 方法只能綁定到 document元素.
  • 你可以得到返回的AJAX內容 察看XML和HTML的xhr.responseXML 或 xhr.responseHTML 之間的分別。

五、.ajaxError()

描述: Ajax請求出錯時註冊一個回調處理函數,這是一個 Ajax Event.
XMLHttpRequest 對象和設置作爲參數傳遞給回調函數。捕捉到的錯誤可作爲最後一個參數傳遞。

參數
ajaxError(fn(event, jqXHR, ajaxSettings, thrownError))

  • fn(event, jqXHR, ajaxSettings, thrownError):類型: Function()被調用的函數。

每當一個Ajax請求出錯時,jQuery就會觸發ajaxError事件,在這個時間點所有處理函數會使用.ajaxError()方法註冊並執行。

注意

  • 這裏的handler處理器調用跨域的腳本和跨域的JSONP請求。
  • 從 jQuery 1.8 開始, .ajaxError() 方法只能綁定到 document元素.
  • 如果global選項設置爲false,調用$.ajax() 或 $.ajaxError()方法將不會被觸發。

六、.ajaxError()

描述: 在AJAX 請求完成時執行一個處理函數,這是一個 Ajax Event.
XMLHttpRequest 對象和設置作爲參數傳遞給回調函數。捕捉到的錯誤可作爲最後一個參數傳遞。

參數
ajaxError(fn(event, jqXHR, ajaxSettings, thrownError))

  • fn(event, jqXHR, ajaxSettings, thrownError):類型: Function()被調用的函數。

每當一個Ajax請求完成,jQuery檢查是否有任何其他響應過程中的Ajax請求(注:未完成的請求)。如果都執行完成,jQuery就會觸發ajaxStop事件,在這個時間點所有處理函數都會使用.ajaxStop()方法註冊並執行。如果一個未處理完成的Ajax請求用beforeSend回調函數返回false取消,ajaxStop事件也被觸發。

注意

  • 從 jQuery 1.8 開始, .ajaxStop() 方法只能綁定到 document元素.
  • 如果global選項設置爲false,調用$.ajax() 或 $.ajaxStop()方法將不會被觸發。
發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章