返回介绍

.error()

发布于 2017-09-11 字数2246 浏览 1009 评论 0

所属分类:事件 > 浏览器事件 | 弃用 > 1.8 版本弃用的 API

.error( handler(eventObject) )返回: jQueryversion deprecated: 1.8

描述: 为 JavaScript 的 “error” 事件绑定一个处理函数。

  • 添加的版本: 1.0.error( handler(eventObject) )

    • handler(eventObject)
      类型: Function()
      每当事件触发时执行的函数。
  • 添加的版本: 1.4.3.error( [eventData ], handler(eventObject) )

    • eventData
      类型: Object

      一个对象,它包含的数据键值对映射将被传递给事件处理程序。

    • handler(eventObject)
      类型: Function()
      每当事件触发时执行的函数。

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

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

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

<img alt="Book" id="book" />

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

$('#book')
  .error(function() {
    alert('Handler for .error() called.')
  })
  .attr("src", "missing.png");

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

Handler for .error() called.

这个事件处理程序必须在浏览器触发error事件之前绑定,这就是为什么示例绑定的处理函数后设置src属性。此外,当页面保存到本地的时候此事件可能无法正确触发。由于error依赖于正常的HTTP状态码,如果URL使用file:协议,它通常不会被触发。

注意:一个jQuery的error事件处理器不应该附加到window对象上。当一个脚本错误的时候,浏览器就会触发 window 的 error 事件。无论如何, window 的 error 事件接收不同的参数和返回值与传统的事件不一样。若要绑定 window 的 error 事件,请使用window.onerror代替。

例子:

为 IE 用户隐藏 “无效的图片” 图标,并使用自定义图片来代替。:

$("img")
  .error(function(){
    $(this).hide();
  })
  .attr("src", "missing.png");

您暂时不能评论!

管理员开启了需要登录才能够评论,你可以免费注册一个本站的账号。

还没有评论!

目前还没有任何评论,快来抢沙发吧!