.error()

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

描述: 绑定一个事件处理器到“错误”JavaScript事件上。

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

    handler(eventObject)每当事件触发时执行的函数。

  • version added: 1.4.3.error( [ eventData ], handler(eventObject) )

    eventData将要传递给事件处理函数的数据映射。

    handler(eventObject)每当事件触发时执行的函数。

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

error事件被发送到元素,比如一张图片,通过文件引用,由浏览器加载。如果没有正确装入,这个事件就会被调用。

例子,考虑一个简单的图像页面:

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

事件处理器可以绑定到图像上:

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

如果图像无法加载(例如,因为不存在目前所提供的URL),警告显示:

Handler for .error() called.

当页面保存到本地的时候此事件可能无法正确触发。由于error依赖于正常的HTTP状态码,如果URL使用file:协议,它通常不会被触发。

注意:一个jQuery的error事件处理器不应该附加到window对象上。当一个脚本错误的时候,浏览器就会触发窗口的错误事件。无论如何,窗口错误事件接收不同的参数,并有不同的返回值比传统的事件处理器的要求。

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();
});
设计酷,jquery1.6 api中文手册