.error()

Categories: Events > Browser Events

.error( handler(eventObject) ) 返回： jQuery

描述： 綁定一個事件處理器到“錯誤”JavaScript事件上。

version added: 1.0.error( handler(eventObject) )

handler(eventObject)每當(dāng)事件觸發(fā)時執(zhí)行的函數(shù)。
version added: 1.4.3.error( [ eventData ], handler(eventObject) )

eventData將要傳遞給事件處理函數(shù)的數(shù)據(jù)映射。

handler(eventObject)每當(dāng)事件觸發(fā)時執(zhí)行的函數(shù)。

這個方法是 .bind('error', handler) 的快捷方式。

error事件被發(fā)送到元素，比如一張圖片，通過文件引用，由瀏覽器加載。如果沒有正確裝入，這個事件就會被調(diào)用。

例子，考慮一個簡單的圖像頁面：

<img src="missing.png" alt="Book" id="book" />

事件處理器可以綁定到圖像上：

$('#book').error(function() {
  alert('Handler for .error() called.')
});

如果圖像無法加載（例如，因?yàn)椴淮嬖谀壳八峁┑腢RL），警告顯示：

Handler for .error() called.

當(dāng)頁面保存到本地的時候此事件可能無法正確觸發(fā)。由于error依賴于正常的HTTP狀態(tài)碼，如果URL使用file:協(xié)議，它通常不會被觸發(fā)。

注意：一個jQuery的error事件處理器不應(yīng)該附加到window對象上。當(dāng)一個腳本錯誤的時候，瀏覽器就會觸發(fā)窗口的錯誤事件。無論如何，窗口錯誤事件接收不同的參數(shù)，并有不同的返回值比傳統(tǒng)的事件處理器的要求。

$(window).error(function(){
  return true;
});

$("img").error(function(){
  $(this).hide();
});