当前位置: 首页 > 中文手册 > jQuery.live() 函数详解

jQuery.live() 函数详解

live()函数用于为指定元素的一个或多个事件绑定事件处理函数

此外,你还可以额外传递给事件处理函数一些所需的数据。

即使是执行live()函数之后新添加的元素,只要它匹配当前jQuery对象的选择器,绑定的事件处理函数仍然对其有效。

此外,可以为同一元素、同一事件类型绑定多个事件处理函数。触发事件时,jQuery会按照绑定的先后顺序依次执行绑定的事件处理函数。

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

从jQuery 1.7开始,该函数被标记为已过时;从jQuery 1.9开始被移除。请使用on()函数来替代。即使在1.7版本之前,也强烈不推荐使用该函数。如果能够不使用该函数,就不要使用。

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

语法

jQuery 1.3 新增该函数,从jQuery 1.7开始被标记为已过时,在jQuery 1.9被移除。其主要有以下两种形式的用法:

用法一:jQuery 1.4 新增支持参数data

jQueryObject.live( events [, data ], handler )

用法二:jQuery 1.4.3 新增支持该用法。

jQueryObject.live( eventsMap )

参数

参数描述
eventsString类型一个或多个用空格分隔的事件类型和可选的命名空间,例如"click"、"focus click"、"keydown.myPlugin"。
data可选/任意类型触发事件时,需要通过event.data传递给事件处理函数的任意数据。
handlerFunctilive类型指定的事件处理函数。
eventsMapObject类型一个Object对象,其每个属性对应事件类型和可选的命名空间(参数events),属性值对应绑定的事件处理函数(参数handler)。

关于参数events中可选的命名空间(1.4.3+才支持),请参考最下面的示例代码。

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

参数handler的返回值与DOM原生事件的处理函数返回值作用一致。例如"submit"(表单提交)事件的事件处理函数返回false,可以阻止表单的提交。

如果事件处理函数handler仅仅只用于返回false值,可以直接将handler设为false

返回值

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

重要说明

live()函数并不是直接在当前jQuery对象匹配的每个元素上绑定事件处理函数,而是将事件处理函数"委托"给document对象来处理。由于DOM 2级的事件流机制,当事件触发时,该事件会在事件冒泡中传递给其所有的祖辈元素,一直传递到document对象为止。当事件流传递到document时,jQuery会判断当前匹配元素是否符合触发条件,如果该元素符合当前jQuery对象的选择器,jQuery就会捕获该事件,从而执行绑定的事件处理函数。

使用live()函数需要注意以下问题:

  • 当前jQuery对象必须通过选择器字符串构造,否则无法处理触发的事件。
  • 在调用该函数之前,jQuery会尝试查找当前jQuery选择器所匹配的元素。在大文档中这可能比较耗时。
  • 该函数不支持方法链。例如:$("a").find(".foo").live(...)是无效的,且无法按照预期正常工作。
  • 由于live()的事件处理函数全部附加到document对象上,因此在事件被处理之前,事件可能要经过最长最慢的事件路径。
  • 在由于平台或事件差异,有些事件不支持冒泡,从而无法冒泡传递到document,此时可能无法处理该事件。
  • 由于live()函数的事件处理函数全部附加在document对象上,如果通过某些方式解除了document对象上的事件绑定,可能会波及到使用live()函数委托绑定的其他元素的事件处理函数。例如$(document).off()

示例&说明

以点击事件("click")为例,以下是jQuery中事件函数的常规用法(某些函数也存在其它形式的用法,此处暂不列出):

// 这里的选择器selector用于指定可以触发事件的元素
// 这里的选择器ancestor应是selector的祖辈元素,selector触发的事件可以被其祖辈元素在事件流中捕获,从而以"代理"的形式触发事件。

// jQuery 1.0+ (1.4.3+支持参数data)
$("selector").click( [ data ,] handler );

// jQuery 1.0+ (1.4.3+支持参数data)
$("selector").bind( "click" [, data ], handler );

// jQuery 1.3+ (1.4+支持参数data)
$("selector").live( "click" [, data ], handler );

// jQuery 1.4.2+
$("ancestor").delegate( "selector", "click" [, data ], handler );

// jQuery 1.7+
$("ancestor").on( "click", "selector" [, data ], handler );

请参考下面这段初始HTML代码:

<div id="n1">
	<p id="n2"><span>CodePlayer</span></p>
	<p id="n3"><span>专注于编程开发技术分享</span></p>
	<em id="n4">http://www.365mini.com</em>
</div>
<p id="n5">Google</p>

我们为<div>中的所有<p>元素绑定点击事件:

//为div中的所有p元素的click事件绑定事件处理函数
//只有n2、n3可以触发该事件
$("div p").live("click", function(){
// 这里的this指向触发点击事件的p元素(Element)
	alert( $(this).text() );
});

运行代码(以下其他代码请自行复制到演示页面运行)

此外,我们还可以同时绑定多个事件,并为事件处理函数传递一些附加的数据,我们可以通过jQuery为事件处理函数传入的参数event(Event事件对象)来进行处理:

var obj = { id: 5, name: "王五" };

//为n5绑定mouseenter mouseleave两个事件,并为其传入附加数据obj
// 附加数据可以是任意类型
$("#n5").live("mouseenter mouseleave", obj, function(event){
	var $me = $(this);
	var obj = event.data; // 这就是传入的附加数据
	if( event.type == "mouseenter"){
		$me.html( "你好," + obj.name + "!");
	}else if(event.type == "mouseleave" ){
		$me.html( "再见," + obj.name + "!");		
	}			
} );

此外,即使符合条件的元素是live()函数执行后新添加,绑定事件对其依然有效。同样以初始HTML代码为例,我们可以编写如下jQuery代码:

//为div中的所有p元素的click事件绑定事件处理函数
//只有n2、n3可以触发该事件
$("div p").live("click", function(event){
	alert( $(this).text() );
});

//后添加的n6也可以触发上述click事件,因为它也是div中的p元素
$("#n1").append('<p id="n6">上述绑定的click事件对此元素也生效!</p>');

参数events还支持为事件类型附加额外的命名空间。当为同一元素绑定多个相同类型的事件处理函数时。使用命名空间,可以在触发事件、移除事件时限定触发或移除的范围。

function clickHandler(event){
	alert( "触发时的命名空间:[" + event.namespace + "]");
}

var $p = $("p");

// A:为所有p元素绑定click事件,定义在foo和bar两个命名空间下
$p.live( "click.foo.bar", clickHandler );

// B:为所有p元素绑定click事件,定义在test命名空间下
$p.live( "click.test", clickHandler );

var $n2 = $("#n2");

// 触发所有click事件
$n2.trigger("click"); // 触发A和B (event.namespace = "")

// 触发定义在foo命名空间下的click事件
$n2.trigger("click.foo"); // 触发A (event.namespace = "foo")
// 触发定义在bar命名空间下的click事件
$n2.trigger("click.bar"); // 触发A (event.namespace = "bar")
// 触发同时定义在foo和bar两个命名空间下的click事件
$n2.trigger("click.foo.bar"); // 触发A (event.namespace = "bar.foo")

// 触发定义在test命名空间下的click事件
$n2.trigger("click.test"); // 触发B (event.namespace = "test")

live()函数的参数eventsMap是一个对象,可以"属性-值"的方式指定多个"事件类型-处理函数"。对应的示例代码如下:

var eventsMap = {
	"mouseenter": function(event){
		$(this).html( "你好!");		
	},
	
	"mouseleave": function(event){
		$(this).html( "再见!");
	}
};

//为n5绑定mouseenter mouseleave两个事件
$("#n5").live( eventsMap );
16 1
我们认为: 用户的主要目的,是为了获取有用的信息,而不是来点击广告的。因此本站将竭力做好内容,并将广告和内容进行分离,确保所有广告不会影响到用户的正常阅读体验。用户仅凭个人意愿和兴趣爱好点击广告。
我们坚信:只有给用户带来价值,用户才会给我们以回报。
CodePlayer技术交流群1CodePlayer技术交流群1

帮朋友打一个硬广告:

P2P网贷系统(Java版本) 新年低价大促销,多年P2P技术积累,系统功能完善(可按需定制,可支持第三方存管、银行存管),架构稳定灵活、性能优异、二次开发快速简单。 另可提供二次开发、安装部署、售后维护、安全培训等一条龙服务。

外行看热闹,内行看门道。可以自信地认为,在系统设计上,比市面上的晓风、迪蒙、方维、绿麻雀、国融信、金和盛等P2P系统要好。
深圳地区支持自带技术人员现场考察源代码、了解主要技术架构,货比三家,再决定是否购买。

也可推荐他人购买,一旦完全成交,推荐人可获得实际售价 10% 的返现。
有意向者,详情请 点击这里 联系,工作时间立即回复。