- 作者:nuysoft/高云 QQ:47214707 EMail:nuysoft@gmail.com
- 声明:本文为原创文章,如需转载,请注明来源并保留原文链接。
- 后文预告:封装事件对象 便捷接口解析 ready专题
- 10.4 .bind() .one()
- 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事件被生成,并传递给<div>,待<div>处理
- 2. 因为<div>没有直接绑定click事件,因此事件沿着DOM树进行冒泡传递
- 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事件被生成,并传递给<div>,待<div>处理
- * 2. 因为<div>没有直接绑定click事件,因此事件沿着DOM树进行冒泡传递
- * 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专题