jQuery源码解析之click()的事件绑定

摘要：阶段二目标浏览器找到监听器后，就运行该监听器阶段三冒泡目标到祖在事件自下而上到达目标节点的过程中，浏览器会检测不是针对该事件的监听器用来捕获事件，并运行非捕获事件的监听器。注意下这种情况，是在里的具体实现，即调用一次后，就执行，卸载事件。

前言：
这篇依旧长，请耐心看下去。

一、事件委托
DOM有个事件流特性，所以触发DOM节点的时候，会经历3个阶段：
（1）阶段一：Capturing 事件捕获（从祖到目标）
在事件自上（document->html->body->xxx）而下到达目标节点的过程中，浏览器会检测 针对该事件的 监听器（用来捕获事件），并运行捕获事件的监听器。

（2）阶段二：Target 目标
浏览器找到监听器后，就运行该监听器

（3）阶段三：Bubbling 冒泡（目标到祖）
在事件自下而上（document->html->body->xxx）到达目标节点的过程中，浏览器会检测不是 针对该事件的 监听器（用来捕获事件），并运行非捕获事件的监听器。

二、$().click()
作用：
为目标元素绑定点击事件

源码：

  //这种写法还第一次见，将所有鼠标事件写成字符串再换成数组
  //再一一绑定到DOM节点上去
  //源码10969行
  jQuery.each( ( "blur focus focusin focusout resize scroll click dblclick " +
    "mousedown mouseup mousemove mouseover mouseout mouseenter mouseleave " +
    "change select submit keydown keypress keyup contextmenu" ).split( " " ),
    function( i, name ) {
      //事件绑定
      // Handle event binding
      jQuery.fn[ name ] = function( data, fn ) {
        return arguments.length > 0 ?
          //如果有参数的话，就用jQuery的on绑定
          this.on( name, null, data, fn ) :
          //否则使用trigger
          this.trigger( name );
      };
    } );

解析：
可以看到，jQuery 将所有的鼠标事件都一一列举了出来，并通过jQuery.fn[ name ] = function( data, fn ) { xxx }

如果有参数，则是绑定事件，调用 on() 方法；
没有参数，则是调用事件，调用 trigger() 方法（ trigger() 放到下篇讲 ）

三、$().on()
作用：
在被选元素及子元素上添加一个或多个事件处理程序

源码：

  //绑定事件的方法
  //源码5812行
  jQuery.fn.extend( {
    //在被选元素及子元素上添加一个或多个事件处理程序
    //$().on("click",function()=<{})
    //源码5817行
    on: function( types, selector, data, fn ) {
      return on( this, types, selector, data, fn );
    },
    //xxx
    //xxx
})

最终调用的是 jQuery.on() 方法：

  //绑定事件的on方法
  //源码5143行
  //目标元素，类型（click,mouseenter,focusin,xxx）,回调函数function(){xxx}
  function on( elem, types, selector, data, fn, one ) {
    var origFn, type;
    //这边可以不看
    // 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 ) {
        on( elem, type, selector, data, types[ type ], one );
      }
      return elem;
    }
    //直接调用$().on()的话会走这边
    if ( data == null && fn == null ) {

      // ( types, fn )
      //fn赋值为selector，即function(){}
      fn = selector;
      //再将selector置为undefined
      //注意这个写法，连等赋值
      data = selector = undefined;
    }
    //调用像$().click()的话会走这边
    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 elem;

    }
    //one()走这里
    if ( one === 1 ) {
      //将fn赋给origFn后，再定义fn
      origFn = fn;
      fn = function( event ) {
        //将绑定给目标元素的事件传给fn，
        //并通过$().off()卸载掉
        // Can use an empty set, since event contains the info
        jQuery().off( event );
        //在origFn运行一次的基础上，让origFn调用fn方法，arguments即event
        return origFn.apply( this, arguments );
      };
      //让fn和origFn使用相同的guid，这样就能移除origFn方法
      // Use same guid so caller can remove using origFn
      fn.guid = origFn.guid || ( origFn.guid = jQuery.guid++ );
    }

    return elem.each( function() {
      //最终调动$.event.add方法
      jQuery.event.add( this, types, fn, data, selector );

    } );
  }

解析：
可以看到，由于将 bind()、live() 和 delegate() 都合并进 on() 后，on() 里面的情况挺复杂的， data、selector、fn 相互赋值。

注意下 if ( one === 1 ) 这种情况，是 $().one()在on()里的具体实现，即调用一次on()后，就执行jQuery().off( event )，卸载事件。

该方法最终调用 jQuery.event.add( ) 方法

四、jQuery.event.add( )
作用：
为目标元素添加事件

源码：

 //源码5235行
  /*
 * Helper functions for managing events -- not part of the public interface.
 * Props to Dean Edwards" addEvent library for many of the ideas.
 */
  jQuery.event = {

    global: {},
    //源码5241行
    //this, types, fn, data, selector
    add: function( elem, types, handler, data, selector ) {

      var handleObjIn, eventHandle, tmp,
        events, t, handleObj,
        special, handlers, type, namespaces, origType,
        //elemData正是目标元素jQuery中的id属性
        //初始值是{}
        elemData = dataPriv.get( elem );
      // Don"t attach events to noData or text/comment nodes (but allow plain objects)
      if ( !elemData ) {
        return;
      }
      //调用者可以传入一个自定义数据对象来代替处理程序
      // Caller can pass in an object of custom data in lieu of the handler
      if ( handler.handler ) {
        handleObjIn = handler;
        handler = handleObjIn.handler;
        selector = handleObjIn.selector;
      }
      //确保不正确的选择器会抛出异常
      // Ensure that invalid selectors throw exceptions at attach time
      // Evaluate against documentElement in case elem is a non-element node (e.g., document)
      if ( selector ) {
        jQuery.find.matchesSelector( documentElement, selector );
      }

      //确保handler有唯一的id
      // Make sure that the handler has a unique ID, used to find/remove it later
      if ( !handler.guid ) {
        handler.guid = jQuery.guid++;
      }
      //如果事件处理没有，则置为空对象
      // Init the element"s event structure and main handler, if this is the first
      //在这里，就应经给events赋值了，
      // 注意这种写法:赋值的同时，判断
      if ( !( events = elemData.events ) ) {
        events = elemData.events = {};
      }

      if ( !( eventHandle = elemData.handle ) ) {
        eventHandle = elemData.handle = function( e ) {

          //当在一个页面卸载后调用事件时，取消jQuery.event.trigger()的第二个事件
          // Discard the second event of a jQuery.event.trigger() and
          // when an event is called after a page has unloaded

          //jQuery.event.triggered: undefined
          //e.type: click/mouseout
          return typeof jQuery !== "undefined" && jQuery.event.triggered !== e.type ?
            //让elem调用jQuery.event.dispatch方法，参数是arguments
            jQuery.event.dispatch.apply( elem, arguments ) : undefined;
        };
      }
      //通过空格将多个events分开，一般为一个，如click
      // Handle multiple events separated by a space
      types = ( types || "" ).match( rnothtmlwhite ) || [ "" ];
      t = types.length;
      while ( t-- ) {
        tmp = rtypenamespace.exec( types[ t ] ) || [];
        //click
        type = origType = tmp[ 1 ];
        //""
        namespaces = ( tmp[ 2 ] || "" ).split( "." ).sort();
        // There *must* be a type, no attaching namespace-only handlers
        if ( !type ) {
          continue;
        }
        //如果event改变了它自己的type，就使用特殊的event handlers
        // If event changes its type, use the special event handlers for the changed type
        special = jQuery.event.special[ type ] || {};
        //如果选择器已定义，确定一个特殊event api的type
        //否则使用默认type
        // If selector defined, determine special event api type, otherwise given type
        type = ( selector ? special.delegateType : special.bindType ) || type;
        //不明白为什么在上面要先写一遍
        // Update special based on newly reset type
        special = jQuery.event.special[ type ] || {};
        //handleObj会传递给所有的event handlers
        // handleObj is passed to all event handlers
        handleObj = jQuery.extend( {
          type: type,
          origType: origType,
          data: data,
          handler: handler,
          guid: handler.guid,
          selector: selector,
          needsContext: selector && jQuery.expr.match.needsContext.test( selector ),
          namespace: namespaces.join( "." )
        }, handleObjIn );
        
        //第一次绑定事件，走这里
        // Init the event handler queue if we"re the first
        if ( !( handlers = events[ type ] ) ) {
          handlers = events[ type ] = [];
          handlers.delegateCount = 0;

          // Only use addEventListener if the special events handler returns false
          if ( !special.setup ||
            special.setup.call( elem, data, namespaces, eventHandle ) === false ) {
            //目标元素有addEventListener的话，调用绑定click事件
            if ( elem.addEventListener ) {
              elem.addEventListener( type, eventHandle );
            }
          }
        }
        //special的add/handleObj.handler.guidd的初始化处理
        if ( special.add ) {
          special.add.call( elem, handleObj );

          if ( !handleObj.handler.guid ) {
            handleObj.handler.guid = handler.guid;
          }
        }

        // Add to the element"s handler list, delegates in front
        if ( selector ) {
          handlers.splice( handlers.delegateCount++, 0, handleObj );
        } else {
          handlers.push( handleObj );
        }
        //一旦有绑定事件，全局通知
        // Keep track of which events have ever been used, for event optimization
        jQuery.event.global[ type ] = true;
      }

    },

...
...

}

解析：
可以看到，很多的 if 判断，都是在初始化对象，最后通过 while 循环，调用目标元素的 addEventListener 事件，也就是说，click()/on() 的本质是 element.addEventListener() 事件，前面一系列的铺垫，都是在为目标 jQuery 对象添加必要的属性。

注意写法 if ( !( events = elemData.events ) )，在赋值的同时，判断条件

（1）dataPriv

  //取唯一id
  //源码4361行
  var dataPriv = new Data();

在 jQuery 对象中，有唯一id的属性

$("#one")

elemData = dataPriv.get( elem )

① Data()

  //目标元素的jQuery id
  //源码4209行
  function Data() {
    this.expando = jQuery.expando + Data.uid++;
  }

② jQuery.expando

  jQuery.extend( {
    //相当于jQuery为每一个元素取唯一的id
    ///D/g : 去掉非数字的字符
    // Unique for each copy of jQuery on the page
    //源码360行
    expando: "jQuery" + ( version + Math.random() ).replace( /D/g, "" ),
    ...  
    ...
})

③ Math.random()
伪随机，到小数点后16位

expando: "jQuery" + ( version + Math.random() ).replace( /D/g, "" ),

可以看到 jQuery 的 id 是由 jQuery + 版本号+ Math.random() 生成的

关于 Math.random() 是如何生成伪随机数的请看：https://www.zhihu.com/question/22818104

（2）rtypenamespace

  var
    rkeyEvent = /^key/,
    rmouseEvent = /^(?:mouse|pointer|contextmenu|drag|drop)|click/,
    //事件类型的命名空间
    //举例：var arr1 = "click.aaa.bbb".match(rtypenamespace);
    //console.log(arr1);//["click.aaa.bbb", "click", "aaa.bbb", index: 0, input: "click.aaa.bbb"]
    //源码5131行
    rtypenamespace = /^([^.]*)(?:.(.+)|)/;

综上，绑定事件的本质即调用element.addEventListener()方法，但 jQuery 有太多的情况需要考虑了。

（完）