jQuery事件处理(七)

时间:2022-01-13 12:42:12

1、自定义事件(用户手动trigger的一般都是自定义事件)

trigger: function( event, data, elem, onlyHandlers ) {

  var i, cur, tmp, bubbleType, ontype, handle, special,

    // 如果没有传入elem(绑定到那个DOM元素上的事件),则默认为document
    eventPath = [ elem || document ],

    // core_hasOwn是hasOwnProperty的替代,检测event上是否有type属性,如果有就将其赋值给type,否则说明event就是type
    type = core_hasOwn.call( event, "type" ) ? event.type : event,

    // 事件的命名空间处理
    namespaces = core_hasOwn.call( event, "namespace" ) ? event.namespace.split(".") : [];

    cur = tmp = elem = elem || document;

  // 如果元素时文本节点或者是注释则直接返回
  if ( elem.nodeType === 3 || elem.nodeType === 8 ) {
    return;
  }

  // 排除替代事件??
  if ( rfocusMorph.test( type + jQuery.event.triggered ) ) {
    return;
  } 

  // 如果type中有.号,

  if ( type.indexOf(".") >= 0 ) {
    // 得到自定事件的所有命名空间
    namespaces = type.split(".");

    // 第一个是自定义事件的类型
    type = namespaces.shift();

    // 
    namespaces.sort();
  }

  // 如果type中没有冒号,则为type加上“on”
  ontype = type.indexOf(":") < 0 && "on" + type;

  // 看看有没有jQuery封装后的event对象的标记,如果没有则进行一下改造
  event = event[ jQuery.expando ] ?
    event :
    new jQuery.Event( type, typeof event === "object" && event );

  // 为event对象添加一些额外的属性
  event.isTrigger = onlyHandlers ? 2 : 3;
  event.namespace = namespaces.join(".");
  event.namespace_re = event.namespace ?
    new RegExp( "(^|\\.)" + namespaces.join("\\.(?:.*\\.|)") + "(\\.|$)" ) :
    null;

  // 重置event的result属性
  event.result = undefined;

  // 如果event没有target属性,则将elem赋值给它
  if ( !event.target ) {
    event.target = elem;
  }

  // 将传入的data放到数组中,并将event放到数组的第二个元素位置
  data = data == null ?
    [ event ] :
    jQuery.makeArray( data, [ event ] );

  // 看看是不是特殊事件,如果是,用特殊事件的处理方式,并在返回false时返回。
  special = jQuery.event.special[ type ] || {};
  if ( !onlyHandlers && special.trigger && special.trigger.apply( elem, data ) === false ) {
    return;
  }

  // 如果不是onlyHandlers 并且特殊事件不需要冒泡,并且不是window
  if ( !onlyHandlers && !special.noBubble && !jQuery.isWindow( elem ) ) {

    // 如果有替代事件类型,则使用替代事件类型

    bubbleType = special.delegateType || type;

    // 如果不是foucusin和foucusout事件
    if ( !rfocusMorph.test( bubbleType + type ) ) {

      // 则将当前指定为该元素的父元素
      cur = cur.parentNode;
    }

    // 遍历自身及其所有祖先元素,因为自动义事件不会向上冒泡
    for ( ; cur; cur = cur.parentNode ) {

      // 将他们推入eventpath中。
      eventPath.push( cur );
      tmp = cur;
    }

    // 如果最后一个cur是document,则事件触发到window对象上,将window推入队列
    if ( tmp === (elem.ownerDocument || document) ) {
      eventPath.push( tmp.defaultView || tmp.parentWindow || window );
    }
  }

  // 触发该元素上的所有事件处理函数
  i = 0;
  while ( (cur = eventPath[i++]) && !event.isPropagationStopped() ) {

    event.type = i > 1 ?
      bubbleType :
      special.bindType || type;

    // 拿到对应的event和handle
    handle = ( data_priv.get( cur, "events" ) || {} )[ event.type ] && data_priv.get( cur, "handle" );
    if ( handle ) {

      // 如果有handle就触发
      handle.apply( cur, data );
    }

    // 拿到原始的事件类型
    handle = ontype && cur[ ontype ];

    // 看是否需要阻止默认事件
    if ( handle && jQuery.acceptData( cur ) && handle.apply && handle.apply( cur, data ) === false ) {
      event.preventDefault();
    }
  }  

  // 事件类型可能变了,重新赋值
  event.type = type;

  // 如果不需要阻止默认事件
  if ( !onlyHandlers && !event.isDefaultPrevented() ) {

    if ( (!special._default || special._default.apply( eventPath.pop(), data ) === false) &&
      jQuery.acceptData( elem ) ) {

      如果存在原始类型,并且存在事件处理函数,并且不是window
      if ( ontype && jQuery.isFunction( elem[ type ] ) && !jQuery.isWindow( elem ) ) {

        // 元素上的事件赋值给临时变量
        tmp = elem[ ontype ];

        // 清空该元素上的原始事件

        if ( tmp ) {
          elem[ ontype ] = null;
        }

        // 防止再次触发
        jQuery.event.triggered = type;

        // 触发事件处理程序
        elem[ type ]();

        // 清除标记防止再次触发的标记
        jQuery.event.triggered = undefined;

        if ( tmp ) {

          // 再把原始事件写回来
          elem[ ontype ] = tmp;
        }
      }
    }
  }

  // 返回最后一个事件处理程序的返回值

  return event.result;
},