10.4.1 如何使用
.bind( eventType, [eventData], handler(eventObject) ) 在匹配的元素上绑定指定类型的事件处理函数
.bind( eventType, [eventData], preventBubble ) 第三个参数为false,则阻止浏览器默认行为并停止事件冒泡,默认true
.bind( events ) 绑定多个事件,events的键为事件类型,值为对应的事件处理函数
.one( eventType, [eventData], handler(eventObject) ) 在匹配的元素上绑定指定类型的事件处理函数,这个函数最多执行一次
其实是改写了事件处理函数,函数执行时先解绑定,再执行
10.4.2 调用过程
jQuery.fn.bind →jQuery.event.add
jQuery.fn.one →jQuery.event.add
10.4.3 源码分析
/**
* bind:
* .bind( eventType, [eventData], handler(eventObject) ) 在匹配的元素上绑定指定类型的事件处理函数
* .bind( eventType, [eventData], preventBubble ) 第三个参数为false,则阻止浏览器默认行为并停止事件冒泡,默认true
* .bind( events ) 绑定多个事件,events的键为事件类型,值为对应的事件处理函数
*
* one:
* .one( eventType, [eventData], handler(eventObject) ) 在匹配的元素上绑定指定类型的事件处理函数,这个函数最多执行一次
* 其实是改写了事件处理函数,函数执行时先解绑定,再执行
*/
jQuery.each(["bind", "one"], function( i, name ) {
// 为jQuery对象扩展bind、one方法
jQuery.fn[ name ] = function( type, data, fn ) {
var handler;
// Handle object literals
// 绑定多个事件,key为事件类型,type[key]是事件处理函数
if ( typeof type === "object" ) { //
for ( var key in type ) {
this[ name ](key, data, type[key], fn);
}
return this;
}
// 修正参数:如果没有传入data,或data为false,(jQuery的这种写法很巧妙,但是可读性太差)
// 如果有两个参数,则认为忽略了data:type, fn,结果是:type, undefined, fn
// 如果data是false,则认为是type, false, fn,结果是:type, undefined, false
if ( arguments.length === 2 || data === false ) {
fn = data;
data = undefined;
}
if ( name === "one" ) { // 只执行一次
handler = function( event ) { // 创建一个新的事件处理函数句柄
jQuery( this ).unbind( event, handler ); // 先删除事件
return fn.apply( this, arguments ); // 再执行传入的事件处理函数fn,这里this是DOM元素
};
handler.guid = fn.guid || jQuery.guid++; // 同步guid,重新包装后的函数与原始函数的guid统一
} else {
handler = fn;
}
if ( type === "unload" && name !== "one" ) { // 如果是unload事件,则只执行一次
this.one( type, data, fn ); // 迭代调用,没有清晰的结构很危险
} else {
for ( var i = 0, l = this.length; i < l; i++ ) {
jQuery.event.add( this[i], type, handler, data ); // 遍历匹配的元素,并绑定事件处理函数
}
}
// 返回jQuery对象,使得可以继续链式调用
return this;
};
});
10.4.4 jQuery.event.add
.bind()和.one()都调用了jQuery.event.add来实现,为元素elem添加类型types的句柄handler,事实上所有的事件绑定最后都通过jQuery.event.add来实现。其执行过程大致如下:
1. 先调用jQuery._data从$.cache中取出已有的事件缓存(私有数据,Cache的解析详见数据缓存)
2. 如果是第一次在DOM元素上绑定该类型事件句柄,在DOM元素上绑定jQuery.event.handle,作为统一的事件响应入口
3. 将封装后的事件句柄放入缓存中
传入的事件句柄,会被封装到对象handleObj的handle属性上,此外handleObj还会填充guid、type、namespace、data属性;DOM事件句柄elemData.handle指向jQuery.event.handle,即jQuery在DOM元素上绑定事件时总是绑定同样的DOM事件句柄jQuery.event.handle。
事件句柄在缓存$.cache中的数据结构如下,事件类型和事件句柄都存储在属性events中,属性handle存放的执行这些事件句柄的DOM事件句柄:
elemData = {
events: {
'click' : [
{ guid: 5, type: 'click', namespace: '', data: undefined,
handle: { guid: 5, prototype: {} }
},
{ ... }
],
'keypress' : [ ... ]
},
handle: { // DOM事件句柄
elem: elem,
prototype: {}
}
}
看看jQuery.event.add的源码解析:
jQuery.event = {
// Bind an event to an element
// Original by Dean Edwards
// 为元素elem添加类型types的句柄handler
add: function( elem, types, handler, data ) {
// 忽略Text Comment
if ( elem.nodeType === 3 || elem.nodeType === 8 ) {
return;
}
if ( handler === false ) { // 如果事件处理函数是false,则用returnFalse代替false
handler = returnFalse; // returnFalse会取消事件的默认行为
} else if ( !handler ) {
// Fixes bug #7229. Fix recommended by jdalton
return; // 如果handler是undefined null '',则直接返回,不执行后边的代码
}
var handleObjIn, handleObj;
if ( handler.handler ) { // 如果已经是封装过的jQuery事件对象(JS真是愁人啊,弱类型,只能通过特性、属性判断对象的类型)
handleObjIn = handler; // handleObj是DOM事件句柄对象(丰富后的jQuery.event.handle)
handler = handleObjIn.handler; // handler始终是个函数
}
// Make sure that the function being executed has a unique ID
if ( !handler.guid ) { // 如果没有分配唯一id,则分配一个
handler.guid = jQuery.guid++;
}
// Init the element's event structure
// 内部数据存储在内部对象上,因此elemData不应该为空,除非elem不支持jQuery缓存(embed、object、applet)
var elemData = jQuery._data( elem ); // 仅仅调用_data接口一次,后续直接在返回的对象上操作
// If no elemData is found then we must be trying to bind to one of the
// banned noData elements
// 如果elemData不存在,说明是一个不支持缓存的元素上绑定事件,直接返回
if ( !elemData ) {
return;
}
var events = elemData.events, // 事件类型和事件句柄都存储在属性events中
eventHandle = elemData.handle; // 属性handle存放的执行这些事件句柄的DOM事件句柄
if ( !events ) {
elemData.events = events = {}; // 初始化一个存放事件的对象,事件名为key,事件函数为value
}
if ( !eventHandle ) { // 初始化一个执行事件函数的函数
elemData.handle = eventHandle = function( e ) {
// Discard the second event of a jQuery.event.trigger() and
// when an event is called after a page has unloaded
// 调用jQuery.event.handler
// jQuery.event.handler是什么意思?
return typeof jQuery !== "undefined" && (!e || jQuery.event.triggered !== e.type) ?
jQuery.event.handle.apply( eventHandle.elem, arguments ) :
undefined;
};
}
// Add elem as a property of the handle function
// This is to prevent a memory leak with non-native events in IE.
// 内存泄漏?
// 将elem作为eventHandle的属性存储,用来避免IE中非本地事件的内存泄漏
eventHandle.elem = elem;
// Handle multiple events separated by a space
// jQuery(...).bind("mouseover mouseout", fn);
types = types.split(" "); // 同时绑定的多个事件可以用空格隔开
// 为什么有的地方用字符串直接量,有的地方要用正则呢?因为正则可以进行全局匹配g
var type, i = 0, namespaces;
while ( (type = types[ i++ ]) ) { // 又一种遍历数组的方法,故意秀技巧么?
handleObj = handleObjIn ?
jQuery.extend({}, handleObjIn) :
{ handler: handler, data: data }; // 创建事件句柄对象,后边还会添加属性:guid anmespace type
// Namespaced event handlers
// 如果事件字符串中有句号.,则说明有命名空间
if ( type.indexOf(".") > -1 ) {
namespaces = type.split(".");
type = namespaces.shift(); // 取出第一个元素
handleObj.namespace = namespaces.slice(0).sort().join("."); // 将于下部分作为命名空间,存储到属性namespace中
} else {
namespaces = [];
handleObj.namespace = ""; // 没有命名空间
}
handleObj.type = type; // 事件类型
if ( !handleObj.guid ) {
handleObj.guid = handler.guid; // 事件对象唯一id
}
// Get the current list of functions bound to this event
var handlers = events[ type ], // 事件句柄队列,取出已经存在函数数组
special = jQuery.event.special[ type ] || {}; // 特殊处理的事件
// Init the event handler queue
if ( !handlers ) { // 如果没有绑定事件,则初始化为一个空数组
handlers = events[ type ] = []; //
// Check for a special event handler
// Only use addEventListener/attachEvent if the special
// events handler returns false
// 如果特殊事件没有setup属性 或setup返回false,则用浏览器原生的绑定事件接口addEventListener/addEventListener,例如live事件
if ( !special.setup || special.setup.call( elem, data, namespaces, eventHandle ) === false ) {
// Bind the global event handler to the element
// 绑定事件句柄
if ( elem.addEventListener ) {
elem.addEventListener( type, eventHandle, false ); // jQuery绑定的事件默认都是起泡阶段捕获
} else if ( elem.attachEvent ) {
elem.attachEvent( "on" + type, eventHandle ); // IE事件模型中没有2级DOM事件模型具有的事件捕捉的概念,只有起泡阶段
}
}
}
if ( special.add ) { // 如果有add方法,就调用
special.add.call( elem, handleObj );
if ( !handleObj.handler.guid ) { // 始终保证事件句柄有唯一的id
handleObj.handler.guid = handler.guid;
}
}
// Add the function to the element's handler list
// 将句柄对象handleObj,加入到句柄数组handler中,
// handleObj包含以下属性:data 唯一guid 命名空间namespace 事件类型type handler函数
handlers.push( handleObj );
// Keep track of which events have been used, for event optimization
// 记录已经使用的事件,用于事件优化?怎么个优化?
jQuery.event.global[ type ] = true;
}
// Nullify elem to prevent memory leaks in IE
// 将elem置为null,避免IE中的内存泄漏(这行代码真是坑爹啊,没有无数次的测试确认,怎么可能想到这行代码呢)
elem = null;
},
// ...
};
10.5 .unbind()
10.5.1 如何使用
.unbind( [eventType] [, handler(eventObject)] ) 从匹配的元素上删除一个之前绑定的事件句柄
如果没有参数,删除所有事件句柄
.unbind( eventType, false ) 删除通过.bind( eventType, false )绑定的事件句柄
.unbind( event ) 看不懂。。。
10.5.2 调用过程
jQuery.fn.unbind →jQuery.event.remove
10.5.3 源码分析
jQuery.fn.extend({
// 删除句柄:删除一个或多个之前附加的事件句柄,jQuery事件只在起泡阶段捕获,不需要再定义控制捕获阶段的参数
unbind: function( type, fn ) {
// Handle object literals
// 一次删除多个事件句柄,key是事件类型,type[key]是事件句柄(这里是迭代复用)
// !type.preventDefault 表明这不是一个就jQuery事件对象
if ( typeof type === "object" && !type.preventDefault ) {
for ( var key in type ) {
this.unbind(key, type[key]);
}
// 到这里,type可能是字符串,也可能是jQuery事件对象
} else {
for ( var i = 0, l = this.length; i < l; i++ ) {
jQuery.event.remove( this[i], type, fn ); // 调用remove删除句柄
}
}
return this;
},
// ...
};
10.5.4 jQuery.event.remove
.unbind()通过调用jQuery.event.remove,删除之前绑定的一个或多个事件句柄,事实上所有的句柄删除最后都通过jQuery.event.remove实现,其执行过程大致如下:
1. 现调用jQuery._data从缓存$.cache中取出elem对应的所有数组(内部数据,与调用jQuery.data存储的数据稍有不同
2. 如果未传入types则移除所有事件句柄,如果types是命名空间,则移除所有与命名空间匹配的事件句柄
3. 如果是多个事件,则分割后遍历
4. 如果未指定删除哪个事件句柄,则删除事件类型对应的全部句柄,或者与命名空间匹配的全部句柄
5. 如果指定了删除某个事件句柄,则删除指定的事件句柄
6. 所有的事件句柄删除,都直接在事件句柄数组jQuery._data( elem ).events[ type ]上调用splice操作
7. 最后检查事件句柄数组的长度,如果为0,或为1但要删除,则移除绑定在elem上DOM事件
8. 最后的最后,如果elem对应的所有事件句柄events都已删除,则从缓存中移走elem的内部数据
9. 在以上的各个过程,都要检查是否有特例需要处理
看看它的源码分析:
jQuery.event = {
// ...
/**
* 移除元素elem上的一个或多个或一组事件
* pos 指要移除的是第几个types事件,可以减少遍历次数
* handler的属性guid唯一标识某个事件对象,移除时通过比较guid是否相等
*/
remove: function( elem, types, handler, pos ) { // add/remove都是作为jQuery内部接口使用
// don't do events on text and comment nodes
// 忽略文本元素Text和注释元素Comment
if ( elem.nodeType === 3 || elem.nodeType === 8 ) {
return;
}
if ( handler === false ) { // 替换布尔型handler为函数,保证handler始终是一个函数,使得remove接口的使用更加便捷
handler = returnFalse;
}
var ret, type, fn, j, i = 0, all, namespaces, namespace, special, eventType, handleObj, origType,
elemData = jQuery.hasData( elem ) && jQuery._data( elem ), // 如果在缓存cache中有数据,则取出,否则elemData为undefine
// 因为jQuery._data总是返回一个对象,因此要先判断缓存cache中是否有数组
events = elemData && elemData.events; // 取出事件句柄数组,用正则表达式可以将多行代码合并为一行,这里可以用if-else或三元表达式代替
if ( !elemData || !events ) { // 如果未绑定,则忽略本次调用,直接返回
return;
}
// types is actually an event object here
// 如果types是一个jQuery Event对象,则。。。
if ( types && types.type ) {
handler = types.handler;
types = types.type;
}
// Unbind all events for the element
// 如果types为false(强制转换类型),则移除所有事件
// 如果types是字符串,并且以句号开头,则移除types命名空间下的指定事件(type+types)
if ( !types || typeof types === "string" && types.charAt(0) === "." ) {
types = types || "";
for ( type in events ) { // 遍历events,移除所有已绑定的事件,这里是迭代调用,jQuery的源码很精致,能复用的代码会尽量复用
jQuery.event.remove( elem, type + types ); // 全部事件,或某一命名空间下的全部事件
}
return;
}
// Handle multiple events separated by a space
// jQuery(...).unbind("mouseover mouseout", fn);
// 同时移除多个事件,事件之间用空格隔开,使得remove接口很灵活
types = types.split(" ");
// 个人觉的变量i的定义与使用离得那么远,不是好习惯,像这种局部使用的变量,应该哪里用就在哪里定义
// 可能作者觉得集中定义显得代码不凌乱吧
while ( (type = types[ i++ ]) ) { // 有一种循环方式
origType = type;
handleObj = null;
all = type.indexOf(".") < 0; // all在这里表示移除的是type命名空间下的全部事件对象,小于0表示不是以.开头
// all为true表示是事件,false表示命名空间
namespaces = [];
if ( !all ) { // 如果以.开头,即type是命名空间,构建命名空间正则表达式
// Namespaced event handlers
namespaces = type.split("."); // 全部命名空间
type = namespaces.shift(); // 取出第一个作为事件类型,其余的为命名空间
namespace = new RegExp("(^|\\.)" +
jQuery.map( namespaces.slice(0).sort(), fcleanup ).join("\\.(?:.*\\.)?") + "(\\.|$)");
// 这里要动态创建正则,因此用了new RegExp 的方式
}
eventType = events[ type ]; // 取出type对应的事件对象数组
if ( !eventType ) { // 如果type对应的事件对象数组不存在,则跳过本次循环(既然不存在就不必移除了)
continue;
}
if ( !handler ) { // 没有指定移除哪个事件对象,handler其实是一个带有guid属性的函数,因为通过guid可以找到对应的事件对象,因此这里依然称handler为事件对象
for ( j = 0; j < eventType.length; j++ ) { // 遍历事件对象数组,这里因为是遍历一个动态的数组,所以没有定义eventType.length变量
handleObj = eventType[ j ];
if ( all || namespace.test( handleObj.namespace ) ) { // 如果是事件或命名空间匹配
jQuery.event.remove( elem, origType, handleObj.handler, j ); // 取出事件对象,迭代调用remove接口
// handleObj.handler有guid属性,因此迭代调用remove依然可以匹配到对应handleObj,事实上这里也可以改写为传入handleObj
// 注意最后一个参数j,remove的pos不为null,就不会在其他地方被splice删除,所以下一行才会splice(这个问题的处理太乱了)
eventType.splice( j--, 1 ); // 如果循环遍历的是一个变化的数组,则可以用这种方式:j++之前先执行j--,保证不会因为数组下标的错误导致某些数组元素遍历不到,秀!
}
}
// 如果未指定删除哪个事件句柄,则删除事件类型对应的全部句柄,或者与命名空间匹配的全部句柄
// 这里对$.cache的操作,是通过对eventType = jQuery._data( elem ).events[ type ]的直接操作进行维护,直接操作事件句柄数组
// 如果是我,可能会再开发一个接口供客户端进行这种微操,其实没必要。
continue;
}
// 到这里,说明指定事件句柄handler
special = jQuery.event.special[ type ] || {}; // 特例
// 如果没有指定pos,则默认从0开始遍历,这里的pos可以减少遍历次数,提高性能,多么精致的代码
// 本人喜欢这种极致的代码,更喜欢优雅的代码,更注重代码的可读性,稍微的性能下降可以接受
for ( j = pos || 0; j < eventType.length; j++ ) {
handleObj = eventType[ j ];
if ( handler.guid === handleObj.guid ) { // 比较事件函数的guid和时间对象的guid,===可以避免类型转换,稍微提高性能
// remove the given handler for the given type
if ( all || namespace.test( handleObj.namespace ) ) {
if ( pos == null ) { // 如果没有指定pos,匹配到后就删除
eventType.splice( j--, 1 ); // j++之前先j--,避免数组变化导致遍历错误
}
if ( special.remove ) { // 如果有自定义的remove方法,则调用(似乎只有live有add remove方法)
special.remove.call( elem, handleObj );
}
}
// 因为guid是全局唯一的,所以匹配到guid对应的事件就可以退出了
if ( pos != null ) { // 如果pos不为null,说明是要删除指定的事件对象,任务完成,退出
break;
}
}
}
// remove generic event handler if no more handlers exist
// 如果type对应的事件对象数组为空,或者发现只剩一个,则移除绑定在elem上浏览器原生事件
if ( eventType.length === 0 || pos != null && eventType.length === 1 ) {
// 检查special是否有自定义的teardown,优先调用
// 这一行的巧妙支出在于:
// 1. special不会为null或undefined,如果没有找到会被赋值为{},是空设置模式的应用
// 2. 首先巧妙的判断special.teardown是否存在,如果不存在则认为是普通事件,如果存在则可以调用teardown
// 3. 在jQuery源码中你看到过没有返回值的函数码?似乎没有,teardown返回false表示失败,还得用普通方式删除
if ( !special.teardown || special.teardown.call( elem, namespaces ) === false ) {
jQuery.removeEvent( elem, type, elemData.handle );
}
ret = null; // 这个变量搞笑了,自从定义之后就从来就没用过,明显多余,可以遗留代码里的变量吧
delete events[ type ]; // 删除类型属性,还是直接对数组句柄数组操作,根本没有什么缓存微操接口
}
}
// Remove the expando if it's no longer used
// 从jQuery.cache中移除elem的数据,最后检查elemData.events
if ( jQuery.isEmptyObject( events ) ) {
var handle = elemData.handle;
if ( handle ) {
handle.elem = null; // 置空,删除对HTML元素的引用,避免因垃圾回收机制不起作用导致的浏览器内存泄漏
// 这是一个非常好的技巧,我们在JavaScript中引用完HTML元素后一定要置空。
}
delete elemData.events; // 删除存储事件句柄的对象
delete elemData.handle; // 删除DOM事件句柄
if ( jQuery.isEmptyObject( elemData ) ) { // 都删了难道还不是isEmptyObject?有点多余,除非某些浏览器不支持delete,可问题是不支持也得移除数据,还是多余!
jQuery.removeData( elem, undefined, true ); // 彻底的从缓存中移走elem的内部数据(存储在属性expando上)
}
}
},
// ...
};
10.6 .live() .die()
10.6.1 如何使用
live 在匹配当前选择器的元素上绑定一个事件处理函数,包括已经存在的和未来添加的,即任何添加的元素只要匹配当前选择器,就会被绑定事件处理函数
.live( eventType, handler ) 在匹配当前选择器的元素上绑定一个指定类型的事件处理函数
.live( eventType, eventData, handler ) eventData可以传递数据给事件处理函数
.live( events ) 绑定多个事件
.die() 删除之前通过.live()绑定的全部事件句柄
.die( eventType [, handler] ) eventType是字符串事件类型,删除一个或一类之前通过.live()绑定的事件句柄
.die( eventTypes ) eventTypes是Map对象,删除多类事件句柄
10.6.2 调用过程
.live()方法永远不会将事件绑定到匹配的元素上,而是将事件绑定到祖先元素(document或context),由该祖先元素代理子元素的事件。
以$('.clickme').live('click', function() { …} ) 为例,当在新添加的元素上点击时,执行过程如下:
1. click事件被生成,并传递给
2. 因为
3. 事件冒泡传递直到到达DOM树的根节点,在根节点上绑定了.live()指定的原始事件处理函数(在1.4以后的版本中,.live()绑定事件到上下文context,以提升性能)
4. 执行.live()指定的事件处理函数
5. 原始事件处理函数检查event的target属性以确定是否继续执行,检查的方式是$(event.target).closes
6. 如果匹配,则原始事件处理函数执行,上下位被设置为找到的元素
因为第5步的检查是在执行原始事件处理函数之前,因此元素可以在任何时候添加,并且事件可以生效
调用过程:
$('div').live( 'click', function(){ alert(1); } )
jQuery.fn.live →jQuery.event.add →jQuery._data →jQuery.event.special.live.add →jQuery.event.add
$('div').die( 'click', function(){ alert(1); } )
jQuery.fn.die →jQuery.fn.unbind →jQuery.event.remove jQuery._data
调试过程中发现个有趣的现象:在父节点上绑定live事件,而不是具体的时间类型?
10.6.3 源码分析
看看.live()/.die()的源码分析:
// 事件类型修正
var liveMap = {
focus: "focusin",
blur: "focusout",
mouseenter: "mouseover",
mouseleave: "mouseout"
};
// die 移除用live附加的一个或全部事件处理函数
// 对应关系:bind-unbind, live-die, delegate-undelegate
/**
* live 在匹配当前选择器的元素上绑定一个事件处理函数,包括已经存在的,和未来添加的,即任何添加的元素只要匹配当前选择器就会被绑定事件处理函数
* .live( eventType, handler ) 在匹配当前选择器的元素上绑定一个指定类型的事件处理函数
* .live( eventType, eventData, handler ) eventData可以传递给事件处理函数
* .live( events ) 绑定多个事件
*
*
* 参考文档:
* http://api.jquery.com/live
* http://www.codesky.net/article/doc/201004/20100417042278.htm
* http://hi.baidu.com/silveringsea/blog/item/55cd25016ecde30c1c958341.html
*
* 如何使用
* 示例
* 局限
* 修正
*
* live被翻译为鲜活绑定、延迟绑定(更准确些)
* live通过委派,而不是在匹配元素上直接绑定事件来实现
*
* 官方文档翻译:事件代理
* .live()方法能对尚未添加到DOM文档中的元素生效。
* .live()方法永远不会将事件绑定到匹配的元素上,而是将事件绑定到祖先元素(document或context),由该祖先元素代理子元素的事件。 *
* 以$('.clickme').live('click', function() { …} ) 为例,当在新添加的元素上点击时,执行过程如下:
* 1. click事件被生成,并传递给
* 2. 因为
* 3. 事件冒泡传递直到到达DOM树的根节点,在根节点上绑定了.live()指定的原始事件处理函数(在1.4以后的版本中,.live()绑定事件到上下文context,以提升性能)
* 4. 执行.live()指定的事件处理函数
* 5. 原始事件处理函数检查event的target属性以确定是否继续执行,检查的方式是$(event.target).closest(".clickme")
* 6. 如果匹配,则原始事件处理函数执行,上下位被设置为找到的元素
*
* 因为第5步的检查是在执行原始事件处理函数之前,因此元素可以在任何时候添加,并且事件可以生效
*
*/
jQuery.each(["live", "die"], function( i, name ) {
jQuery.fn[ name ] = function( types, data, fn, origSelector /* Internal Use Only */ ) {
var type, i = 0, match, namespaces, preType,
selector = origSelector || this.selector, // 选择器表达式
// 很巧妙,如果没有origSelector,那么采用当前jQuery对象的选择器,、
// 可是,如果origSelector为true,后边的处理对象就变成了以origSelector为选择器的jQuery对象
context = origSelector ? this : jQuery( this.context ); // 上下文,
// 这里也是,如果没有origSelector,那么上下文就变成当前jQuery对象的上下文
// 可是,如果origSelector为true(类型转换),当前jQuery对象就变成上下文了
// 就是在这里,通过一个内部变量,改变了选择器表达式和上下分,区分开了live/die和delegate/undelegate,用同样的代码实现了两种接口
// 一次绑定或删除多个事件
if ( typeof types === "object" && !types.preventDefault ) { // types不是jQuery事件对象
for ( var key in types ) { // 迭代复用
context[ name ]( key, data, types[key], selector );
}
return this;
}
// 如果是die,移除origSelector匹配元素上的所有通过live绑定的事件
// 没有指定事件类型+ origSelector + origSelector是CSS选择器
if ( name === "die" && !types &&
origSelector && origSelector.charAt(0) === "." ) {
context.unbind( origSelector ); // 事实上bind/unbind是基础,add/remove/tigger/handle是所有事件的基础
return this;
}
// 修正参数(如果data为false或没有传入data参数)
// 完整:types, data, fn, origSelector
// types, false, fn, origSelector
// 或types, fn, origSelector
if ( data === false || jQuery.isFunction( data ) ) {
fn = data || returnFalse;
data = undefined;
}
types = (types || "").split(" "); // 多个事件用空格隔开
while ( (type = types[ i++ ]) != null ) { // 遍历事件类型数组
match = rnamespaces.exec( type ); // 取到第一个.后的命名空间
namespaces = "";
if ( match ) { // 如果有命名空间,即事件类型后还有.
namespaces = match[0]; // .+命名空间
type = type.replace( rnamespaces, "" ); // 过滤.+命名空间,初学者会尝试用indexOf查找.的位置,然后截取
}
if ( type === "hover" ) { // 将hover分解为mouseenter mouseleave,继续遍历
types.push( "mouseenter" + namespaces, "mouseleave" + namespaces );
continue;
}
preType = type; //
if ( liveMap[ type ] ) { // 修正事件名名,修正其实不准确,比如遇到focus,绑定了两个:focus focusin,不会造成两次事件响应么?
types.push( liveMap[ type ] + namespaces ); // 将修正后的事件类型入队,因为用了while循环,所有不必担心遍历动态数组的问题
type = type + namespaces; // 再恢复type,包含了命名空间,这不是蛋疼么,把命名空间去掉只为了检测hover和是否需要修正?
} else {
type = (liveMap[ type ] || type) + namespaces; // 修正事件名,这里可以直接写成:type + namespaces
// 这行的逻辑有点问题,已经知道liveMap[ type ]是false了,这个地方的代码有些重复
}
/**
* 上边的if-else改写为:
* if ( liveMap[ type ] ) types.push( liveMap[ type ] + namespaces )
* type = type + namespaces
*/
// 这里开始live的特殊处理,虽说live/die的逻辑比较接近,再加上delegate/undelegate,复用的粒度小但是很精髓
// 同时为了减少接口,并没有将公共部分提取出来,总的来说,live/die这段代码出来的还是刚刚好
if ( name === "live" ) {
// bind live handler
for ( var j = 0, l = context.length; j < l; j++ ) {
// 绑定到上下文,事件类型经过liveConvert后变为live.type.selector
// 前边做了那么多铺垫,这行才是关键!
// add: function( elem, types, handler, data ) {
// context[j] 如果有origSelector则是当前jQuery对象,如果没有则是当前jQuery对象的上下文
// live事件的格式比较特殊,应该trigger里会有live的特殊处理,live的处理在特例special里
jQuery.event.add( context[j], "live." + liveConvert( type, selector ),
{ data: data, selector: selector, handler: fn, origType: type, origHandler: fn, preType: preType } );
}
} else {
// unbind live handler
// 删除live绑定的事件句柄
context.unbind( "live." + liveConvert( type, selector ), fn );
}
}
return this;
};
});
/**
* live执行句柄,live绑定的事件调用链:add.eventHandle →handler function liveHandler →_data →handler
* @param event
* @return
*/
function liveHandler( event ) {
var stop, maxLevel, related, match, handleObj, elem, j, i, l, data, close, namespace, ret,
elems = [],
selectors = [],
events = jQuery._data( this, "events" );
// Make sure we avoid non-left-click bubbling in Firefox (#3861) and disabled elements in IE (#6911)
if ( event.liveFired === this || !events || !events.live || event.target.disabled || event.button && event.type === "click" ) {
return;
}
if ( event.namespace ) {
namespace = new RegExp("(^|\\.)" + event.namespace.split(".").join("\\.(?:.*\\.)?") + "(\\.|$)");
}
event.liveFired = this;
var live = events.live.slice(0); // 返回一个新的数组,而不改变原来的数组
for ( j = 0; j < live.length; j++ ) {
handleObj = live[j];
if ( handleObj.origType.replace( rnamespaces, "" ) === event.type ) {
selectors.push( handleObj.selector );
} else {
live.splice( j--, 1 );
}
}
match = jQuery( event.target ).closest( selectors, event.currentTarget );
for ( i = 0, l = match.length; i < l; i++ ) {
close = match[i];
for ( j = 0; j < live.length; j++ ) {
handleObj = live[j];
if ( close.selector === handleObj.selector && (!namespace || namespace.test( handleObj.namespace )) && !close.elem.disabled ) {
elem = close.elem;
related = null;
// Those two events require additional checking
if ( handleObj.preType === "mouseenter" || handleObj.preType === "mouseleave" ) {
event.type = handleObj.preType;
related = jQuery( event.relatedTarget ).closest( handleObj.selector )[0];
// Make sure not to accidentally match a child element with the same selector
if ( related && jQuery.contains( elem, related ) ) {
related = elem;
}
}
if ( !related || related !== elem ) {
elems.push({ elem: elem, handleObj: handleObj, level: close.level });
}
}
}
}
for ( i = 0, l = elems.length; i < l; i++ ) {
match = elems[i];
if ( maxLevel && match.level > maxLevel ) {
break;
}
event.currentTarget = match.elem;
event.data = match.handleObj.data;
event.handleObj = match.handleObj;
ret = match.handleObj.origHandler.apply( match.elem, arguments );
if ( ret === false || event.isPropagationStopped() ) {
maxLevel = match.level;
if ( ret === false ) {
stop = false;
}
if ( event.isImmediatePropagationStopped() ) {
break;
}
}
}
return stop;
}
// 在live事件类型type后增加上selector,作为命名空间
function liveConvert( type, selector ) {
// . > `
// 空格> &
// 在type后增加上selector,作为命名空间
return (type && type !== "*" ? type + "." : "") + selector.replace(rperiod, "`").replace(rspaces, "&"); //
}
10.7 .deletege() .undelegate()
10.7.1 如何使用
.delegate( selector, eventType, handler ) 在匹配选择器表达式selector的元素上,将一个事件句handler柄绑定到一个或多个事件上
无论是现有的还是将来添加的,基于一组特定的根元素(即上下文)
.delegate( selector, eventType, eventData, handler ) Map型对象eventData的属性将被复制到事件句柄handler
.delegate( selector, events ) 绑定一个或多个事件句柄
.undelegate() 在当前jQuery对象上,移除所有live事件句柄
.undelegate( selector, eventType, handler ) 在当前jQuery对象上,移除live. eventType.selector事件句柄
为当前选择所匹配的所有元素移除一个事件处理程序,现在或将来,基于一组特定的根元素。
.undelegate( selector, events ) 在当前jQuery对象上,移除多个live事件句柄,events是Map型对象,key
.undelegate( namespace ) 在当前jQuery对象上,移除命名空间匹配的live事件句柄
从接口的含义看,.deletege()/.undelegate()与.live()/.die()的区别在于绑定事件时的上下文不同,上下文即事件绑定到的元素:
.deletege()/.undelegate() 当前jQuery对象
.live()/.die() 当前jQuery对象的上下文,经常是document,也可以是构造jQuery对象时指定的上下文
10.7.2 调用过程
jQuery.fn.delegate →jQuery.fn.live →jQuery.event.add
jQuery.fn.undelegate →jQuery.fn.unbind/die
10.7.3 源码分析
// 事件代理,调用live方法实现
delegate: function( selector, types, data, fn ) {
// 因为传递了参数selector,live时的上下文变为this,而不是this.context
return this.live( types, data, fn, selector );
},
// 删除事件代理,调用unbind或die实现
undelegate: function( selector, types, fn ) {
if ( arguments.length === 0 ) {
return this.unbind( "live" ); // 在当前jQuery对象上直接unbind,不需要在去查找上下文
} else {
// jQuery.fn[ die ] = function( types, data, fn, origSelector /* Internal Use Only */ ) {
return this.die( types, null, fn, selector ); // 带有选择器字符串,改变了die里的上下文context变量
}
},
本节小节:
1. .bind()/.unbind()高级接口的基础,add/remove/tigger/handle是所有的基础,最后才是调用浏览器原生接口
2. .deletege()/.undelegate()与.live()/.die()的区别在于绑定事件时的父节点不同
后文预告:封装事件对象 便捷接口解析ready专题