您的浏览器过于古老 & 陈旧。为了更好的访问体验, 请 升级你的浏览器
Ready 发布于2014年09月05日 12:59

原创 jQuery.error() 函数详解

1992 次浏览 读完需要≈ 6 分钟

内容目录

error()函数用于为每个匹配元素的error事件绑定处理函数。此外,你还可以额外传递给事件处理函数一些数据。

error事件会在js发生错误或资源加载失败时触发。该事件主要用于window对象、<img>等元素。

此外,你可以为同一元素多次调用该函数,从而绑定多个事件处理函数。触发error事件时,jQuery会按照绑定的先后顺序依次执行绑定的事件处理函数。

要删除通过error()绑定的事件,请使用unbind()函数。

该函数属于jQuery对象(实例)。

语法

jQuery 1.0 新增该函数,但从 1.8 开始被标记为已过时

jQueryObject.error( [ data ,]  handler )

参数

参数 描述
data 可选/任意类型触发事件时,需要通过event.data传递给事件处理函数的任意数据。
handler Function类型指定的事件处理函数。

jQuery 1.4.3 新增支持error()支持data参数。

参数handler中的this指向当前DOM元素。error()还会为handler传入一个参数:表示当前事件的Event对象

返回值

error()函数的返回值为jQuery类型,返回当前jQuery对象本身。

示例&说明

请参考以下HTML示例代码:

<img src="https://codeplayer.vip/static/image/invalid.png" alt="回到顶部" />

现在,我们为<img>元素的error事件绑定处理函数(可以绑定多个,触发时按照绑定顺序依次执行):

$("img").error( function(){
	alert( "图片加载失败!" );
} );

我们还可以为事件处理函数传递一些附加的数据。此外,通过jQuery为事件处理函数传入的参数Event对象,我们可以获取当前事件的相关信息(比如事件类型、触发事件的DOM元素、附加数据等):

var newImageURL = "https://codeplayer.vip/static/image/backTop.png";

// 图片加载失败时,重新加载新的图片URL
$("img").error( newImageURL, function(event){
	this.src = event.data;
} );

运行代码

  • CodePlayer技术交流群1
  • CodePlayer技术交流群2

0 条评论

撰写评论

打开导航菜单