jQuery.on() 函数详解[http://www.365mini.com/page/jquery-on.htm]

中文手册 2014年09月01日 暂无评论

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

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

从jQuery 1.7开始,on()函数提供了绑定事件处理程序所需的所有功能,用于统一取代以前的bind()、 delegate()、 live()等事件函数。

即使是执行on()函数之后新添加的元素,只要它符合条件,绑定的事件处理函数也对其有效。

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

要删除通过on()绑定的事件,请使用off()函数。如果要附加一个事件,只执行一次,然后删除自己,请使用one()函数。

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

语法

jQuery 1.7 新增该函数。其主要有以下两种形式的用法:

用法一

jQueryObject.on( events [, selector ] [, data ], handler )

用法二

jQueryObject.on( eventsMap [, selector ] [, data ] )

参数

参数 描述
events String类型一个或多个用空格分隔的事件类型和可选的命名空间,例如"click"、"focus click"、"keydown.myPlugin"。
eventsMap Object类型一个Object对象,其每个属性对应事件类型和可选的命名空间(参数events),属性值对应绑定的事件处理函数(参数handler)。
selector 可选/String类型一个jQuery选择器,用于指定哪些后代元素可以触发绑定的事件。如果该参数为null或被省略,则表示当前元素自身绑定事件(实际触发者也可能是后代元素,只要事件流能到达当前元素即可)。
data 可选/任意类型触发事件时,需要通过event.data传递给事件处理函数的任意数据。
handler Function类型指定的事件处理函数。

关于参数events中可选的命名空间,请参考最下面的示例代码。

关于参数selector,你可以简单地理解为:如果该参数等于null或被省略,则为当前匹配元素绑定事件;否则就是为当前匹配元素的后代元素中符合selector选择器的元素绑定事件。

参数handler中的this指向当前匹配元素的后代元素中触发该事件的DOM元素。如果参数selector等于null或被省略,则this指向当前匹配元素(也就是该元素)。

on()还会为handler传入一个参数:表示当前事件的Event对象

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

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

返回值

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

重要说明

如果传递了selector参数,那么on()函数并不是为当前jQuery对象匹配的元素绑定事件处理函数,而是为它们的后代元素中符合选择器selector参数的元素绑定事件处理函数。on()函数并不是直接为这些后代元素挨个绑定事件,而是委托给当前jQuery对象的匹配元素来处理。由于DOM 2级的事件流机制,当后代元素selector触发事件时,该事件会在事件冒泡中传递给其所有的祖辈元素,当事件流传递到当前匹配元素时,jQuery会判断是哪个后代元素触发了事件,如果该元素符合选择器selector,jQuery就会捕获该事件,从而执行绑定的事件处理函数。

示例&说明

以点击事件("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").on("click", "p", function(){    // 这里的this指向触发点击事件的p元素(Element)    alert( $(this).text() );});

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

如果要绑定所有的<p>元素,你可以编写如下jQuery代码:

//为所有p元素绑定click事件处理程序(注意:这里省略了selector参数)//n2、n3、n5均可触发该事件$("p").on("click", function(event){// 这里的this指向触发点击事件的p元素(Element)    alert( $(this).text() );});

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

var data = { id: 5, name: "张三" };

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

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

// 为div中的所有p元素绑定click事件处理程序// 只有n2、n3可以触发该事件$("div").on("click", "p", 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.on( "click.foo.bar", clickHandler );

// B:为所有p元素绑定click事件,定义在test命名空间下$p.on( "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")

// 移除所有p元素定义在foo命名空间下的click事件处理函数$p.off( "click.foo" ); // 移除A

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

var data = { id: 5, name: "张三" };

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

//为n5绑定mouseenter mouseleave两个事件,并为其传入附加数据data$("body").on(events, "#n5", data);
时间: 2024-10-20 05:13:41

jQuery.on() 函数详解[http://www.365mini.com/page/jquery-on.htm]的相关文章

jQuery extend函数详解

一 jQuery的扩展方法原型是 $.extend(dest,src1,src2,src3); 含义是将src1,src2,src3合并到dest中,返回值为合并后的dest,该方法合并后,dest的结构被修改. <script> var dest = {'type':'person'} var src1 = {'name':'lisi','age':12} var src2 = {'sex':'male'} var src3 = {'class':'class 1'} var result

jQuery插件开发及jQuery.extend函数详解和jQuery.fn与jQuery.prototype区别

一.jQuery插件开发分为两种:  1.类级别: 类级别你可以理解为拓展jquery类,最明显的例子是$.ajax(...),相当于静态方法. 开发扩展其方法时使用$.extend方法,即jQuery.extend(object); $.extend({ add:function(a,b){return a+b;} , minus:function(a,b){return a-b;} }); var i = $.add(3,2); var j = $.minus(3,2); 2.对象级别: 对

jQuery.hasClass() 函数详解

目录 jQuery.hasClass() 函数详解 语法 参数 返回值 示例&说明 jQuery.hasClass() 函数详解 hasClass()函数用于指示当前jQuery对象所匹配的元素是否含有指定的css类名. 该函数属于jQuery对象(实例). 语法 JavaScript: jQueryObject.hasClass( className ) 参数 参数 描述 className String类型指定的css类名. 返回值 hasClass()函数的返回值是Boolean类型,返回

jQuery.delegate() 函数详解

delegate()函数用于为指定元素的一个或多个事件绑定事件处理函数. 此外,你还可以额外传递给事件处理函数一些所需的数据. 即使是执行delegate()函数之后新添加的元素,只要它符合条件,绑定的事件处理函数仍然对其有效. 此外,该函数可以为同一元素.同一事件类型绑定多个事件处理函数.触发事件时,jQuery会按照绑定的先后顺序依次执行绑定的事件处理函数. 要删除通过delegate()绑定的事件,请使用undelegate()函数. 从jQuery 1.7开始,请优先使用事件函数on()

jQuery.ajaxComplete() 函数详解

ajaxComplete()函数用于设置当AJAX请求完成(无论成功或失败)时执行的回调函数. 这是一个全局AJAX事件函数,用于为所有AJAX请求的ajaxComplete事件绑定事件处理函数.当AJAX请求完成(无论成功或失败)时,将触发ajaxComplete事件,并执行绑定的事件处理函数. 该函数必须在jQuery对象实例上调用,ajaxComplete()将为每个匹配元素的ajaxComplete事件绑定处理函数.当AJAX请求完成后,所有匹配元素上的处理函数都将被触发执行.事件处理函

(转)jQuery.on() 函数详解

www.365mini.com/page/jquery-on.htm on()函数用于为指定元素的一个或多个事件绑定事件处理函数. 此外,你还可以额外传递给事件处理函数一些所需的数据. 从jQuery 1.7开始,on()函数提供了绑定事件处理程序所需的所有功能,用于统一取代以前的bind(). delegate(). live()等事件函数. 即使是执行on()函数之后新添加的元素,只要它符合条件,绑定的事件处理函数也对其有效. 此外,该函数可以为同一元素.同一事件类型绑定多个事件处理函数.触

jQuery.ajax() 函数详解

jQuery.ajax()函数用于通过后台HTTP请求加载远程数据. jQuery.ajax()函数是jQuery封装的AJAX技术实现,通过该函数,我们无需刷新当前页面即可获取远程服务器上的数据. jQuery.ajax()函数是jQuery的底层AJAX实现.jQuery.get(). jQuery.post().load(). jQuery.getJSON(). jQuery.getScript()等函数都是该函数的简化形式(都调用该函数,只是参数设置有所不同或有所省略). 该函数属于全局

jQuery.isEmptyObject() 函数详解 转

原文地址 http://www.365mini.com/page/jquery_isemptyobject.htm jQuery.isEmptyObject()函数用于判断指定参数是否是一个空对象. 所谓"空对象",即不包括任何可枚举(自定义)的属性.简而言之,就是该对象没有属性可以通过for...in迭代. 该函数属于全局jQuery对象. 语法 jQuery 1.4 新增该静态函数. jQuery.isEmptyObject( object ) 参数 参数 描述 object 任意

jQuery.makeArray() 函数详解

jQuery.makeArray()函数用于将一个类数组对象转换为真正的数组对象. 所谓"类数组对象"就是一个常规的Object对象,但它和数组对象非常相似:具备length属性,并以0.1.2.3……等数字作为属性名. 不过它毕竟不是数组,没有从数组的原型对象上继承下来的内置方法(例如:push(). sort()等). jQuery.makeArray( object ) 注意事项: 一个类数组对象,它至少应该具备length属性,哪怕其值为 0,它可以没有"元素&quo