.error()
.error( handler(eventObject) ) 返回: jQuery
描述: 綁定一個(gè)事件處理器到“錯(cuò)誤”JavaScript事件上。
-
version added: 1.0.error( handler(eventObject) )
handler(eventObject)每當(dāng)事件觸發(fā)時(shí)執(zhí)行的函數(shù)。
-
version added: 1.4.3.error( [ eventData ], handler(eventObject) )
eventData將要傳遞給事件處理函數(shù)的數(shù)據(jù)映射。
handler(eventObject)每當(dāng)事件觸發(fā)時(shí)執(zhí)行的函數(shù)。
這個(gè)方法是 .bind('error', handler) 的快捷方式。
error事件被發(fā)送到元素,比如一張圖片,通過文件引用,由瀏覽器加載。如果沒有正確裝入,這個(gè)事件就會(huì)被調(diào)用。
例子,考慮一個(gè)簡(jiǎn)單的圖像頁面:
<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)頁面保存到本地的時(shí)候此事件可能無法正確觸發(fā)。由于
error依賴于正常的HTTP狀態(tài)碼,如果URL使用file:協(xié)議,它通常不會(huì)被觸發(fā)。
注意:一個(gè)jQuery的error事件處理器不應(yīng)該附加到window對(duì)象上。當(dāng)一個(gè)腳本錯(cuò)誤的時(shí)候,瀏覽器就會(huì)觸發(fā)窗口的錯(cuò)誤事件。無論如何,窗口錯(cuò)誤事件接收不同的參數(shù),并有不同的返回值比傳統(tǒng)的事件處理器的要求。
Examples:
Example: To hide JavaScript errors from the user, you can try:
$(window).error(function(){
return true;
});
Example: To hide the "broken image" icons for your IE users, you can try:
$("img").error(function(){
$(this).hide();
});