全局Ajax事件處理程序：.ajaxSend()
- 詳細內容
- 分類：JQuery
- 發佈：2013-08-14, 週三 20:09
- 點擊數：2069
(PS:這篇文章是官網API文件的非專業翻譯+個人意見，並且重新排版過)
全局Ajax事件處理程序：.ajaxSend()
附加上一個函式，在Ajax要求送出前，該函式會被執行。這是一個Ajax事件(AjaxEvent)。
語法：
.ajaxSend( handler(event, jqXHR, ajaxOptions) ) // version added: 1.0
-
handler(event, jqXHR, ajaxOptions)
Type: Function()
The function to be invoked.
當一個Ajax要求要被送出去時，jQuery會觸發ajaxSend事件。此時，每個用.ajaxSend()註冊的處理程序都會被執行。
為了實際觀察這個方法，我們建立了一個基本的Ajax載入要求。
<div class="trigger">Trigger</div> <div class="result"></div> <div class="log"></div>
將下面的事件處理器附加到文件上：
$( document ).ajaxSend(function() {
$( ".log" ).text( "Triggered ajaxSend handler." );
})
現在，用jQuery方法來建立一個Ajax要求：
$( ".trigger" ).click(function() {
$( ".result" ).load( "ajax/test.html" );
})
當使用者按下具有trigger類別的元素時，Ajax要求開始前，log訊息就會出現。
從jQuery1.8開始，.ajaxSend()方法應該只被附加到document上。
不論是哪種Ajax要求要被傳送，所有的ajaxSend處理程序都會被呼叫。假如你需要區分是那些要求(所引發的Ajax事件)，可以利用傳遞給處理程序的參數來辨別。每一次當ajaxSend 處理程序被執行時，會有三個參數傳遞給處理程序，分別是，事件物件，jqXHR 物件(jQuery 1.4中的XMLHttpRequest物件)，以及在要求建立時會被使用的設定物件。
舉例來說，下面程式碼顯示如何限制回呼函式只對具有特定URL的事件進行處理。(下面的例子只對 settings.url === "ajax/test.html" 的事件進行處理，PS: 處理程序的三個參數都是jQuery呼叫該程序時會自動給的)
$( document ).ajaxSend(function( event, jqxhr, settings ) {
if ( settings.url == "ajax/test.html" ) {
$( ".log" ).text( "Triggered ajaxSend handler." );
}
});
其他注意事項：
- 假如$.ajax()或是$.ajaxSetup()在呼叫時設定global選項為false，那.ajaxSend()方法將不會被觸發。
範例：
當Ajax要求傳送前，顯示一個訊息。
$( document ).ajaxSend(function( event, request, settings ) {
$( "#msg" ).append( "<li>Starting request at " + settings.url + "</li>" );
});
按個讚!~支持本站!~