jQuery中的on函数详解：

概述：

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

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

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

即使是执行on()函数之后新添加的元素，只要它符合条件，绑定的事件处理函数也对其有效（jQuery的事件处理机制提供了该特性）。

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

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

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

使用方法

该函数。其主要有以下两种形式的用法：

用法一：

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对象本身。

重要说明：

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

方法的使用示例&说明

使用的html代码片段：

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

<div id="n1">
 jQuery.on Function
 Demo
 Start it 
</div>
Running Men

以点击事件("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);

演示一下：为<div>中的所有标签和为所有的标签绑定“click”事件：

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

//为所有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("mouseentermouseleave","#n5", data,function(event){
var $me = $(this);
var options = event.data;// 这就是传入的附加数据

if( event.type== "mouseenter"){
$me.html("你好，"+ options.name+ "!");
}else if(event.type== "mouse leave"){
$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('<pid="n6">上述绑定的click事件对此元素也生效!');

参数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.11.x版本，该版本与之前的版本不同在于参数有增加了一个one选项，提供更便捷的事件绑定功能

on: function( types, selector, data, fn, /*INTERNAL*/ one ) {
var type, origFn;

// Types can be a map of types/handlers -- 判断参数的类型
 if ( typeof types === "object" ) {
// ( types-Object, selector, data ) -- 如果第一个参数时对象类型也就是：事件类型 ： 处理函数 这样的类型，进入该逻辑分支
 if ( typeof selector !== "string" ) {
// ( types-Object, data )
 data = data || selector;
selector = undefined;
      }
for ( type in types ) {  // 遍历对象的属性，递归的添加事件和事件处理函数
this.on( type, selector, data, types[ type ], one );
      }
return this;
   }

if ( data == null && fn == null ) {
// ( types, fn )
 fn = selector;
data = selector = undefined;
   } else if ( fn == null ) {
if ( typeof selector === "string" ) {
// ( types, selector, fn )
 fn = data;
data = undefined;
      } else {
// ( types, data, fn )
 fn = data;
data = selector;
selector = undefined;
      }
   }
if ( fn === false ) {
fn = returnFalse;
   } else if ( !fn ) {
return this;
   }

if ( one === 1 ) {  // 类似于jQuery.one()的功能
origFn = fn;
fn = function( event ) {
// Can use an empty set, since event contains the info
 jQuery().off( event );
return origFn.apply( this, arguments );
      };
// Use same guid so caller can remove using origFn
 fn.guid = origFn.guid || ( origFn.guid = jQuery.guid++ );
   }
return this.each( function() {  // 核心的事件添加函数其实还是add方法,这里不做代码分析了，之后会在别的源码分析中体现
jQuery.event.add( this, types, fn, data, selector );  
   });
}

想要更深入的理解jQuery的事件处理机制，需要更多的学习add方法的思想，这里由于是介绍jQuery.on函数的，所有在这里就不对add方法进行更多的讲解了，之后会对其进行源码的学习和分析。

秒客网

jQuery.on函数使用详解与源码分析：

jQuery中的on函数详解：

概述：

使用方法

方法的使用示例&说明

源代码学习：

相关文章