$().on()

时间：2023-03-09 01:28:49
$().on()

原文链接：http://www.365mini.com/page/jquery-on.htm

语法

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);

随机推荐

  1. awk脚本

    $0,意即所有域. 有两种方式保存shell提示符下awk脚本的输出.最简单的方式是使用输出重定向符号>文件名,下面的例子重定向输出到文件wow. #awk '{print $0}' grade ...

  2. Where is the Global.asax.cs file

    I am using VS 2008. I have created a new Asp.net web site project from File->New->Website-> ...

  3. Mysql 查看连接数,状态

    命令: show processlist; 如果是root帐号,你能看到所有用户的当前连接.如果是其它普通帐号,只能看到自己占用的连接. show processlist;只列出前100条,如果想全列 ...

  4. AD6电气规则错误报告中英文对照

    Ⅰ:Error Reporting 错误报告 A:Violations Associated with Buses 有关总线电气错误的各类型(共 12 项) ◆ bus indices out of  ...

  5. Maven-009-Nexus 用户密码加密（安全必须）

    信息数据大爆发的时代,我们关心什么?没错,数据安全!数据安全!数据安全!(重要事情说三遍,哈哈哈...) 之前我们存放在 maven settings.xml 文件中的 Nexus 私服用户密码都是明 ...

  6. mysql安装配置问题（linux下）

    1.安装后使用:mysql -u root -p 无法登录mysql 错误提示:ERROR 1045 (28000): Access denied for user 'root'@'localhost ...

  7. C语言之memcpy函数

    昨天自己动手实现memcpy这个函数,用一个例程试了一下,结果正确,满心欢心,可是有些地方想不明白,于是百度了一下,结果自己写的函数简直无法直视. 觉得还是写个总结,以示教训. 先贴上我自己的函数: ...

  8. 自动化环境robot framework安装中问题解决

    在搭建自动化环境的时候需要安装以下程序:

  9. 【Arduino】使用C#实现Arduino与电脑进行串行通讯

    在给Arduino编程的时候,因为没有调试工具,经常要通过使用串口通讯的方式调用Serial.print和Serial.println输出Arduino运行过程中的相关信息,然后在电脑上用Arduin ...

  10. How to run a (Tomcat)Java application server on a Azure virtual machine

    http://www.windowsazure.com/en-us/documentation/articles/virtual-machines-java-run-tomcat-applicatio ...