jQuery源码分析--Event模块(3)

  最后剩下了事件的手动触发了。jQuery提供了两个函数trigger和triggerHandler来手动触发事件,可以触发原生事件和自定义的事件。这个触发不单只会触发有jQuery绑定事件,而且也会触发原生的行内绑定事件。trigger和triggerHander的区别是:
  trgger:会对匹配的所有元素都调用jQuery.event.trrger,而且会冒泡,会触发浏览器默认行为。返回值为jQuery对象
  triggerHandler:只会对第一个匹配的元素调用jQuery.event.trrger,而且不会冒泡,不会触发浏览器默认行为。为函数的返回值
  可以看到都是通过底层的jQuery.event.trrger工具方法来实现。那jQuery.event.trrger是如何工作的呢。

  1. 构造从当前节点到window的一个冒泡路径,用数组来存储。
  2. 遍历这个路径数组,在没有被阻止冒泡的情况下,调用每个节点的jQuery的主监听函数 和 元素的行内监听函数。
  3. 最后用原生的事件触发函数(click,focus)来触发默认行为。并设定一个jQuery.event.triggered标志来标志是触发默认行为,避免再次触发事件。
    最后是源代码。
    trigger: function( event, data, elem, onlyHandlers ) {//event 可以是事件类型、自定义事件对象或jquery事件对象
    
            var i, cur, tmp, bubbleType, ontype, handle, special,
                eventPath = [ elem || document ],//冒泡路劲
                type = hasOwn.call( event, "type" ) ? event.type : event,//判断event是对象(自定义和jquery)还是类型字符串
                namespaces = hasOwn.call( event, "namespace" ) ? event.namespace.split(".") : [];//命名空间
    
            cur = tmp = elem = elem || document;//cur指向当前元素的祖先元素
    
            // Don‘t do events on text and comment nodes
            if ( elem.nodeType === 3 || elem.nodeType === 8 ) {//排除文本节点和注释节点
                return;
            }
    
            // focus/blur morphs to focusin/out; ensure we‘re not firing them right now    rfocusMorph = /^(?:focusinfocus|focusoutblur)$/,
            if ( rfocusMorph.test( type + jQuery.event.triggered ) ) {//过滤掉foces/blur事件的默认行为,后面统一用focusin/focusout
                return;
            }
    
            if ( type.indexOf(".") >= 0 ) {//解析事件类型和命名空间并对命名空间排序 
                // Namespaced trigger; create a regexp to match event type in handle()
                namespaces = type.split(".");
                type = namespaces.shift();
                namespaces.sort();
            }
            ontype = type.indexOf(":") < 0 && "on" + type;//有:号时不调用行内监听事件
    
            // Caller can pass in a jQuery.Event object, Object, or just an event type string
            event = event[ jQuery.expando ] ?//判断是不是jquery监听对象,不是创建。
                event :
                new jQuery.Event( type, typeof event === "object" && event );
    
            // Trigger bitmask: & 1 for native handlers; & 2 for jQuery (always true)
            event.isTrigger = onlyHandlers ? 2 : 3;
            event.namespace = namespaces.join(".");
            event.namespace_re = event.namespace ?
                new RegExp( "(^|\\.)" + namespaces.join("\\.(?:.*\\.|)") + "(\\.|$)" ) :
                null;
    
            // Clean up the event in case it is being reused
            event.result = undefined;//最后一个有返回值的函数的返回值
            if ( !event.target ) {//修正target
                event.target = elem;
            }
    
            // Clone any incoming data and prepend the event, creating the handler arg list
            data = data == null ?//将附加数据(如果有)和事件对象封装成数组。方便apply调用
                [ event ] :
                jQuery.makeArray( data, [ event ] );
    
            // Allow special events to draw outside the lines
            special = jQuery.event.special[ type ] || {};
            if ( !onlyHandlers && special.trigger && special.trigger.apply( elem, data ) === false ) {//先调用修正对象的触发函数来触发
                return;
            }
    
            // Determine event propagation path in advance, per W3C events spec (#9951)   构造冒泡路劲
            // Bubble up to document, then to window; watch for a global ownerDocument var (#9724)
            if ( !onlyHandlers && !special.noBubble && !jQuery.isWindow( elem ) ) {//排除onlyHandlers=true、load、已经到window对象了
    
                bubbleType = special.delegateType || type;//优先使用修正对象的属性
                if ( !rfocusMorph.test( bubbleType + type ) ) {//初始化cur为当前元素的父元素(排除focus/blur)
                    cur = cur.parentNode;
                }
                for ( ; cur; cur = cur.parentNode ) {//遍历
                    eventPath.push( cur );
                    tmp = cur;//tmp指向所能到达的最顶层元素
                }
    
                // Only add window if we got to document (e.g., not plain obj or detached DOM)
                if ( tmp === (elem.ownerDocument || document) ) {//如果最顶层是document再添加window
                    eventPath.push( tmp.defaultView || tmp.parentWindow || window );
                }
            }
    
            // Fire handlers on the event path
            i = 0;
            while ( (cur = eventPath[i++]) && !event.isPropagationStopped() ) {//遍历冒泡路劲  触发监听函数
    
                event.type = i > 1 ?
                    bubbleType :
                    special.bindType || type;
    
                // jQuery handler
                handle = ( data_priv.get( cur, "events" ) || {} )[ event.type ] && data_priv.get( cur, "handle" );//取出主监听函数
                if ( handle ) {//调用主监听函数
                    handle.apply( cur, data );
                }
    
                // Native handler
                handle = ontype && cur[ ontype ];
                if ( handle && handle.apply && jQuery.acceptData( cur ) ) {//执行行内事件监听函数
                    event.result = handle.apply( cur, data );
                    if ( event.result === false ) {//返回值为false代表阻止默认行为
                        event.preventDefault();
                    }
                }
            }
            event.type = type;//回复type
    
            // If nobody prevented the default action, do it now
            if ( !onlyHandlers && !event.isDefaultPrevented() ) {//没有阻止默认行为
    
                if ( (!special._default || special._default.apply( eventPath.pop(), data ) === false) &&
                    jQuery.acceptData( elem ) ) {
    
                    // Call a native DOM method on the target with the same name name as the event.
                    // Don‘t do default actions on window, that‘s where global variables be (#6170)
                    if ( ontype && jQuery.isFunction( elem[ type ] ) && !jQuery.isWindow( elem ) ) {
    
                        // Don‘t re-trigger an onFOO event when we call its FOO() method  避免再次触发行内监听函数
                        tmp = elem[ ontype ];
    
                        if ( tmp ) {
                            elem[ ontype ] = null;
                        }
    
                        // Prevent re-triggering of the same event, since we already bubbled it above   避免再次触发主函数
                        jQuery.event.triggered = type;
                        elem[ type ]();
                        jQuery.event.triggered = undefined;
    
                        if ( tmp ) {//恢复
                            elem[ ontype ] = tmp;
                        }
                    }
                }
            }
    
            return event.result;
        },

     

郑重声明:本站内容如果来自互联网及其他传播媒体,其版权均属原媒体及文章作者所有。转载目的在于传递更多信息及用于网络分享,并不代表本站赞同其观点和对其真实性负责,也不构成任何其他建议。