描述: 附加一个事件处理器到匹配目前选择器的所有元素,现在和未来。
-
添加的版本: 1.3.live( events, handler(eventObject) )
-
events类型: String一个包含一个JavaScript事件类型的字符串,比如”click”或”keydown,”或自定义事件的名称。从jQuery 1.4开始,字符串可以包含多个空格分隔的事件类型或自定义事件的名称。
-
handler(eventObject)类型: Function()每当事件触发时执行的函数。
-
-
添加的版本: 1.4.live( events, data, handler(eventObject) )
-
events类型: String一个包含一个JavaScript事件类型的字符串,比如”click”或”keydown,”或自定义事件的名称。从jQuery 1.4开始,字符串可以包含多个空格分隔的事件类型或自定义事件的名称。
-
data类型: PlainObject一个包含数据的对象将被传递到事件处理程序。
-
handler(eventObject)类型: Function()每当事件触发时执行的函数。
-
-
添加的版本: 1.4.3.live( events )
-
events类型: PlainObject一个或多个JavaScript事件类型的一个普通的对象及其对应的执行函数组成的映射。。
-
从jQuery1.7开始, .live()
方法已经过时了。请使用.on()
附加事件处理程序。 旧版本的jQuery中用户,应优先使用.delegate()
来取代.live()
。
这个方法提供了一种手段,将委托的事件处理程序附加到一个页面的document
元素,从而简化了在页面上动态添加的内容上事件处理的使用。直接与委派事件的讨论,请查看.on()
方法的更多信息。
在其继承者重写.live()
方法是简单的;以下是三种事件添加方法的模板,它们是等价的:
1
2
3
|
|
events
参数可以是一个空格隔开的事件类型名称的列表和可选的命名空间,或事件名称字符串和处理程序的对象。data
参数是可选的,可以省略。例如,以下三种方法调用方式在功能上是相同的(后文还提供了更有效,性能更好的添加代理事件处理的方式):
1
2
3
|
|
因为更高版本的jQuery提供了更好的方法,没有.live()
方法的缺点,所以.live()
方法不再推荐使用。特别是,使用.live()
出现的以下问题:
- 在调用
.live()
方法之前,jQuery 会先获取与指定的选择器匹配的元素,这一点对于大型文档来说是很花费时间的。 - 不支持链式写法。例如,
$("a").find(".offsite, .external").live( ... );
这样的写法是不合法的,并不能像期待的那样起作用。 - 由于所有的
.live()
事件被添加到document
元素上,所以在事件被处理之前,可能会通过最长最慢的那条路径之后才能被触发。 - 在移动 iOS (iPhone, iPad 和 iPod Touch) 上,对于大多数元素而言,
click
事件不会冒泡到文档 body 上,并且如果不满足如下情况之一,就不能和.live()
方法一起使用:- 使用原生的可被点击的元素,例如,
a
或button
,因为这两个元素可以冒泡到document
。 - 在
document.body
内的元素使用.on()
或.delegate()
进行绑定,因为移动 iOS 只有在 body 内才能进行冒泡。 - 需要 click 冒泡到元素上才能应用的 CSS 样式
cursor:pointer
(或者是父元素包含document.documentElement
)。但是依需注意的是,这样会禁止元素上的复制/粘贴功能,并且当点击元素时,会导致该元素被高亮显示。
- 使用原生的可被点击的元素,例如,
- 在事件处理中调用
event.stopPropagation()
来阻止事件处理被添加到 document 之后的节点中,是效率很低的。因为事件已经被传播到document
上。 .live()
方法与其它事件方法的相互影响是会令人感到惊讶的。例如,$(document).unbind("click")
会移除所有通过.live()
添加的 click 事件!
对于仍在使用.live()
的页面,那么下面关于该方法在不同版中的区别,可能会对您有一定帮助:
- 在 jQuery 1.7 之前,如果想阻止通过
.live()
绑定的事件被冒泡到其它元素上,必须在事件处理中返回false
。调用.stopPropagation()
是不起作用的。 - 从 jQuery 1.4 开始,
.live()
方法支持自定义事件,也支持所有 JavaScript 事件冒泡。它还支持一些原本不能冒泡的事件,包括change
,submit
,focus
和blur
。 - 在 jQuery 1.3.x 中,只能绑定如下 JavaScript 事件:
click
,dblclick
,keydown
,keypress
,keyup
,mousedown
,mousemove
,mouseout
,mouseover
, 和mouseup
.
例子:
Example: 点击段落时,添加另一个段落。注意,.live() 会为所有的段落(包括新生成的段落)绑定事件。
1
|
|
Example: 通过使用 preventDefault 方法仅取消默认的动作。
1
2
3
|
|
Example: 使用 .live() 绑定自定义事件。
1
2
3
4
5
6
7
8
9
|
|
Example: 使用映射绑定多个事件处理。注意,.live() 会为所有的段落(包括新生成的段落)绑定 click, mouseover, 和 mouseout 事件。
1
2
3
4
5
6
7
8
9
10
11
|
|
转载请注明:悠然品鉴 » jQuery .live() 用法 手册 | 示例代码