jQuery1.9.1源码分析--Events模块

   1 var rformElems = /^(?:input|select|textarea)$/i,
   2         rkeyEvent = /^key/,
   3         rmouseEvent = /^(?:mouse|contextmenu)|click/,
   4         rfocusMorph = /^(?:focusinfocus|focusoutblur)$/,
   5         rtypenamespace = /^([^.]*)(?:\.(.+)|)$/;
   6 
   7     function returnTrue() {
   8         return true;
   9     }
  10 
  11     function returnFalse() {
  12         return false;
  13     }
  14 
  15     jQuery.event = {
  16         global: {},
  17         /**
  18          * 事件绑定最后都通过jQuery.event.add来实现。其执行过程大致如下:
  19          1.  先调用jQuery._data从$.cache中取出已有的事件缓存(私有数据,Cache的解析详见数据缓存)
  20          2.  如果是第一次在DOM元素上绑定该类型事件句柄,在DOM元素上绑定jQuery.event.handle,作为统一的事件响应入口
  21          3.  将封装后的事件句柄放入缓存中
  22          传入的事件句柄,会被封装到对象handleObj的handle属性上,此外handleObj还会填充guid、type、namespace、data属性;DOM事件句柄elemData.handle指向jQuery.event.handle,即jQuery在DOM元素上绑定事件时总是绑定同样的DOM事件句柄jQuery.event.handle。
  23          事件句柄在缓存$.cache中的数据结构如下,事件类型和事件句柄都存储在属性events中,属性handle存放的执行这些事件句柄的DOM事件句柄:
  24          elemData = {
  25     events: {
  26         'click' : [
  27             { guid: 5, type: 'click', namespace: '', data: undefined,
  28                 handle: { guid: 5, prototype: {} }
  29             },
  30             { ... }
  31         ],
  32         'keypress' : [ ... ]
  33     },
  34     handle: { // DOM事件句柄
  35         elem: elem,
  36         prototype: {}
  37     }
  38 }
  39          */
  40         add: function(elem, types, handler, data, selector) {
  41             var tmp, events, t, handleObjIn,
  42                 special, eventHandle, handleObj,
  43                 handlers, type, namespaces, origType,
  44                 // 创建或获取私有的缓存数据
  45                 elemData = jQuery._data(elem);
  46 
  47             if (!elemData) {
  48                 return;
  49             }
  50 
  51             // 可以给jq的handler对象传参数配置
  52             if (handler.handler) {
  53                 handleObjIn = handler;
  54                 handler = handleObjIn.handler;
  55                 selector = handleObjIn.selector;
  56             }
  57 
  58             // 确保处理程序有唯一ID,以便查找和删除
  59             // handler函数添加guid属性
  60             if (!handler.guid) {
  61                 handler.guid = jQuery.guid++;
  62             }
  63 
  64             // 首次初始化元素的事件结构和主要处理程序
  65             // 缓存数据elemData添加events属性对象
  66             if (!(events = elemData.events)) {
  67                 events = elemData.events = {};
  68             }
  69             // elemData添加handle方法
  70             if (!(eventHandle = elemData.handle)) {
  71                 // 当我们使用jQuery为元素添加事件处理程序时,
  72                 // 实际上就是调用了这个通过包装的函数,
  73                 // 而这里面就是通过jQuery.event.dispatch方法来触发的
  74                 eventHandle = elemData.handle = function(e) {
  75                     // 如果jQuery完成初始化且不存在e或者已经jQuery.event.trigger()了
  76                     // 返回派遣委托后的结果
  77                     // this指向eventHandle.elem,解决ie中注册事件this指向的问题
  78                     // 如果是IE,这里使用attachEvent监听,其事件处理程序的第一个参数就有ie的event了。
  79                     // 平时说的window.event是指在elem['on' + type] = handler;的情况
  80                     return typeof jQuery !== core_strundefined && (!e || jQuery.event.triggered !== e.type) ? jQuery.event.dispatch.apply(eventHandle.elem, arguments) :
  81                         undefined;
  82                 };
  83                 // 给handle函数添加elem属性防止IE非原生内存泄露
  84                 // handle方法添加elem属性
  85                 eventHandle.elem = elem;
  86             }
  87 
  88             // 处理空格分离的多事件
  89             // jQuery(...).bind("mouseover mouseout", fn);
  90             types = (types || '').match(core_rnotwhite) || [''];
  91             t = types.length;
  92             while (t--) {
  93                 tmp = rtypenamespace.exec(types[t]) || [];
  94                 type = origType = tmp[1];
  95                 // 对命名空间进行排序
  96                 // click.a.c.f.d --- a.c.d.f
  97                 namespaces = (tmp[2] || '').split('.').sort();
  98 
  99                 // 事件特例(就是为一些事件类型的一些特殊情况的处理)
 100                 special = jQuery.event.special[type] || {};
 101 
 102                 // 如果有事件特例,就使用。否则还是使用原始type
 103                 type = (selector ? special.delegateType : special.bindType) || type;
 104 
 105                 // 更新事件特例的类型
 106                 special = jQuery.event.special[type] || {};
 107 
 108                 // 给handleObj添加事件处理程序相关信息,
 109                 // 如果target对象有相同属性或方法则替换为handleObj的
 110                 handleObj = jQuery.extend({
 111                     type: type,
 112                     origType: origType,
 113                     data: data,
 114                     handler: handler,
 115                     guid: handler.guid,
 116                     selector: selector,
 117                     needsContext: selector && jQuery.expr.match.needsContext.test(selector),
 118                     namespace: namespaces.join('.')
 119                 }, handleObjIn);
 120 
 121                 // 首次初始化事件处理程序队列
 122                 if (!(handlers = events[type])) {
 123                     handlers = events[type] = [];
 124                     handlers.delegateCount = 0;
 125 
 126                     // 当事件特例处理程序没有setup方法或者setup返回false时使用addEventListener/attachEvent
 127                     if (!special.setup || special.setup.call(elem, data, namespaces, eventHandle) === false) {
 128                         // 给元素绑定事件处理程序,知道这里才真正添加事件处理程序
 129                         if (elem.addEventListener) {
 130                             elem.addEventListener(type, eventHandle, false);
 131                         } else if (elem.attachEvent) {
 132                             elem.attachEvent('on' + type, eventHandle);
 133                         }
 134                     }
 135                 }
 136 
 137                 // 事件特例的一些处理
 138                 if (special.add) {
 139                     special.add.call(elem, handleObj);
 140 
 141                     if (!handleObj.handler.guid) {
 142                         handleObj.handler.guid = handler.guid;
 143                     }
 144                 }
 145 
 146                 // 添加元素的事件处理列表,
 147                 // 如果有selector,则用来给委托事件使用的
 148                 if (selector) {
 149                     handlers.splice(handlers.delegateCount++, 0, handleObj);
 150                 } else {
 151                     handlers.push(handleObj);
 152                 }
 153 
 154                 // 追踪哪个事件曾经被运行过
 155                 jQuery.event.global[type] = true;
 156             }
 157 
 158             // 防止IE内存泄露
 159             elem = null;
 160         },
 161         /**
 162          * 注销元素的事件或者事件集
 163          *
 164          * 通过jQuery.event.remove实现,其执行过程大致如下:
 165          1. 现调用jQuery._data从缓存$.cache中取出elem对应的所有数组(内部数据,与调用jQuery.data存储的数据稍有不同
 166          2. 如果未传入types则移除所有事件句柄,如果types是命名空间,则移除所有与命名空间匹配的事件句柄
 167          3. 如果是多个事件,则分割后遍历
 168          4. 如果未指定删除哪个事件句柄,则删除事件类型对应的全部句柄,或者与命名空间匹配的全部句柄
 169          5. 如果指定了删除某个事件句柄,则删除指定的事件句柄
 170          6. 所有的事件句柄删除,都直接在事件句柄数组jQuery._data( elem ).events[ type ]上调用splice操作
 171          7. 最后检查事件句柄数组的长度,如果为0,或为1但要删除,则移除绑定在elem上DOM事件
 172          8. 最后的最后,如果elem对应的所有事件句柄events都已删除,则从缓存中移走elem的内部数据
 173          9. 在以上的各个过程,都要检查是否有特例需要处理
 174          */
 175         remove: function(elem, types, handler, selector, mappedTypes) {
 176             var j, handleObj, tmp,
 177                 origCount, t, events,
 178                 special, handlers, type,
 179                 namespaces, origType,
 180                 elemData = jQuery.hasData(elem) && jQuery._data(elem);
 181 
 182             if (!elemData || !(events = elemData.events)) {
 183                 return;
 184             }
 185 
 186             types = (types || '').match(core_rnotwhite) || [''];
 187             t = types.length;
 188             while (t--) {
 189                 tmp = rtypenamespace.exec(types[t]) || [];
 190                 type = origType = tmp[1];
 191                 namespaces = (tmp[2] || '').split('.').sort();
 192 
 193                 // 如果没有指定type,解绑元素的所有事件(包括命名空间上的)
 194                 if (!type) {
 195                     for (type in events) {
 196                         jQuery.event.remove(elem, type + types[t], handler, selector, true);
 197                     }
 198                     continue;
 199                 }
 200 
 201                 special = jQuery.event.special[type] || {};
 202                 type = (selector ? special.delegateType : special.bindType) || type;
 203                 // 该事件列表
 204                 handlers = events[type] || [];
 205                 tmp = tmp[2] && new RegExp("(^|\\.)" + namespaces.join("\\.(?:.*\\.|)") + "(\\.|$)");
 206 
 207                 // 删除匹配的事件
 208 
 209                 // 事件列表的长度
 210                 origCount = j = handlers.length;
 211                 while (j--) {
 212                     handleObj = handlers[j];
 213 
 214                     if ((mappedTypes || origType === handleObj.origType) &&
 215                         (!handler || handler.guid === handleObj.guid) &&
 216                         (!tmp || tmp.test(handleObj.namespace)) &&
 217                         (!selector || selector === handleObj.selector || selector === "**" && handleObj.selector)) {
 218                         // 删除events事件列表中的该项
 219                         handlers.splice(j, 1);
 220                         // 如果有委托,delegateCount就减一
 221                         if (handleObj.selector) {
 222                             handlers.delegateCount--;
 223                         }
 224                         if (special.remove) {
 225                             special.remove.call(elem, handleObj);
 226                         }
 227                     }
 228                 }
 229 
 230                 // 删除通用的事件处理程序,同时避免无限递归
 231 
 232                 // 如果原始事件列表有项,经过前面的步骤长度为0
 233                 if (origCount && !handlers.length) {
 234                     if (!special.teardown || special.teardown.call(elem, namespaces, elemData.handle) === false) {
 235                         // 删除注册的侦听事件
 236                         jQuery.removeEvent(elem, type, elemData.handle);
 237                     }
 238 
 239                     // 删除events[type]属性
 240                     delete events[type];
 241                 }
 242             }
 243 
 244             // 如果events不再使用则删除
 245             if (jQuery.isEmptyObject(events)) {
 246                 delete elemData.handle;
 247 
 248                 // 使用removeData检查空的和清空expando
 249                 jQuery._removeData(elem, 'events');
 250             }
 251         },
 252         /**
 253          *
 254          *
 255          * 1.可触发自定义事件
 256          * 2.触发原生事件处理程序
 257          * 1).通过jQuery定义的
 258          * 2).如果触发该类型事件都会触发elem[type]和elem['on' + type]方法,如果没有冒泡阻止,也会触发其他冒泡路径上的元素的ontype方法
 259          *
 260          * @param event
 261          * @param data
 262          * @param elem
 263          * @param onlyHandlers
 264          * @returns {*}
 265          */
 266         trigger: function(event, data, elem, onlyHandlers) {
 267             var handle, ontype, cur,
 268                 bubbleType, special, tmp, i,
 269                 eventPath = [elem || document],
 270                 type = core_hasOwn.call(event, 'type') ? event.type : event,
 271                 namespaces = core_hasOwn.call(event, 'namespace') ? event.namespace.split('.') : [];
 272 
 273             cur = tmp = elem = elem || document;
 274 
 275             if (elem.nodeType === 3 || elem.nodeType === 8) {
 276                 return;
 277             }
 278 
 279             // focus/blur变形为focusin/out,确保我们不会立刻触发它们
 280             if (rfocusMorph.test(type + jQuery.event.triggered)) {
 281                 return;
 282             }
 283 
 284             if (type.indexOf('.') >= 0) {
 285                 namespaces = type.split('.');
 286                 // 取出第一项,事件类型
 287                 type = namespaces.shift();
 288                 // 命名空间排序
 289                 namespaces.sort();
 290             }
 291             ontype = type.indexOf(':') < 0 && 'on' + type;
 292 
 293             // 确保是jQuery的event对象
 294             event = event[jQuery.expando] ?
 295                 event :
 296                 new jQuery.Event(type, typeof event === 'object' && event);
 297 
 298             event.isTrigger = true;
 299             event.namespace = namespaces.join('.');
 300             event.namespace_re = event.namespace ?
 301                 new RegExp('(^|\\.)' + namespaces.join('\\.(?:.*\\.|)') + '(\\.|$)') :
 302                 null;
 303 
 304             // 清除事件,防止被重用
 305             event.result = undefined;
 306             if (!event.target) {
 307                 event.target = elem;
 308             }
 309 
 310             // 克隆来源数据和预先准备事件,创建处理程序参数列表
 311             data = data == null ?
 312                 [event] :
 313                 jQuery.makeArray(data, [event]);
 314 
 315             // 特殊的情况下的trigger
 316             special = jQuery.event.special[type] || {};
 317             if (!onlyHandlers && special.trigger && special.trigger.apply(elem, data) === false) {
 318                 return;
 319             }
 320 
 321             // 保存冒泡时经过的元素到eventPath中,向上冒到document,然后到window;也可能是全局ownerDocument变量
 322             if (!onlyHandlers && !special.noBubble && !jQuery.isWindow(elem)) {
 323                 bubbleType = special.delegateType || type;
 324                 if (!rfocusMorph.test(bubbleType + type)) {
 325                     // 如果不是focus/blur类型,将当前元素改为父节点元素
 326                     cur = cur.parentNode;
 327                 }
 328                 // 一直向上获取父辈元素并存入eventPath数组中
 329                 for (; cur; cur = cur.parentNode) {
 330                     eventPath.push(cur);
 331                     tmp = cur;
 332                 }
 333 
 334                 // 如tmp到了document,我们添加window对象
 335                 if (tmp === (elem.ownerDocument || document)) {
 336                     eventPath.push(tmp.defaultView || tmp.parentWindow || window);
 337                 }
 338             }
 339 
 340             // 在事件路径上触发处理程序, 如果没有阻止冒泡就会遍历eventPath,
 341             // 如果当前元素对应的事件类型有事件处理程序,就执行它,直到到最顶元素。
 342             // 如果阻止,在第一次遍历后就不会再遍历了。
 343             i = 0;
 344             while ((cur = eventPath[i++]) && !event.isPropagationStopped()) {
 345                 event.type = i > 1 ?
 346                     bubbleType :
 347                     special.bindType || type;
 348 
 349                 // jQuery 缓存中的处理程序
 350                 handle = (jQuery._data(cur, 'events') || {})[event.type] && jQuery._data(cur, 'handle');
 351                 // 如果有handle方法,执行它。这里的handle是元素绑定的事件
 352                 if (handle) {
 353                     handle.apply(cur, data);
 354                 }
 355 
 356                 // 触发原生处理程序elem['on' + type]
 357                 handle = ontype && cur[ontype];
 358                 if (handle && jQuery.acceptData(cur) && handle.apply && handle.apply(cur, data) === false) {
 359                     event.preventDefault();
 360                 }
 361             }
 362             event.type = type;
 363 
 364             // 如果没有阻止默认行为动作,处理elem的type属性事件,
 365             // 执行elem[type]处理程序但不会触发elem['on' + type]
 366             if (!onlyHandlers && !event.isDefaultPrevented()) {
 367                 // 1.
 368                 // 1).没有special._default
 369                 // 2).有special._default,该方法的执行结果返回false
 370                 // 2.
 371                 // type不能使click且elem不能使a标签
 372                 // 3.
 373                 // elem可接受缓存
 374                 if ((!special._default || special._default.apply(elem.ownerDocument, data) === false) && !(type === 'click' && jQuery.nodeName(elem, 'a')) && jQuery.acceptData(elem)) {
 375 
 376                     if (ontype && elem[type] && !jQuery.isWindow(elem)) {
 377                         // 缓存older
 378                         tmp = elem[ontype];
 379 
 380                         // 当我们执行foo()时,不会重新触发onfoo事件
 381                         if (tmp) {
 382                             elem[ontype] = null;
 383                         }
 384 
 385                         // 防止再次触发中的相同事件,第一次触发完后jQuery.event.triggered = undefined
 386                         jQuery.event.triggered = type;
 387                         try {
 388                             // 执行方法
 389                             elem[type]();
 390                         } catch (e) {
 391                             // 隐藏元素在focus/blur时,ie9以下会奔溃
 392                         }
 393                         jQuery.event.triggered = undefined;
 394 
 395                         if (tmp) {
 396                             elem[ontype] = tmp;
 397                         }
 398                     }
 399                 }
 400             }
 401 
 402             return event.result;
 403         },
 404         /**
 405          * 派遣事件
 406          * 创建jQuery的event对象来代理访问原生的event,
 407          * 通过jQuery.event.handlers计算出委托事件处理队列handlerQueue(冒泡路径上的元素),没有委托则保存着当前元素和保存着其事件处理相关信息的对象handleObj。
 408          * 遍历委托事件处理队列,再遍历事件处理数组,找到匹配的事件类型,如果有处理程序,就执行它。可以使用event.stopImmediatePropagation()来阻止遍历下一个事件处理数组项。如果当前元素的当前事件处理程序返回值是false或者内部使用了event.stopPropagation()。就不会遍历下一个冒泡路径上的元素了(即当前元素的父级上的元素)
 409          * jQuery.event.special[event.type].preDispatch和jQuery.event.special[event.type].postDispatch分别是派遣事件开始和结束的钩子方法。
 410          * @param event 原生event对象
 411          * @returns {result|*}
 412          */
 413         dispatch: function(event) {
 414             // 从原生event中创建jq的event
 415             event = jQuery.event.fix(event);
 416 
 417             var i, ret, handleObj, matched, j,
 418                 handlerQueue = [],
 419                 args = core_slice.call(arguments),
 420                 // 获取元素在jQuery.cache中的events对象的type数组
 421                 handlers = (jQuery._data(this, 'events') || {})[event.type] || [],
 422                 // 事件特例
 423                 special = jQuery.event.special[event.type] || {};
 424 
 425             // 将第一个event参数替换为jq的event
 426             args[0] = event;
 427             // 设置委托目标
 428             event.delegateTarget = this;
 429 
 430             // 如果存在preDispatch钩子,则运行该方法后退出
 431             if (special.preDispatch && special.preDispatch.call(this, event) === false) {
 432                 return;
 433             }
 434 
 435             // 委托事件队列
 436             handlerQueue = jQuery.event.handlers.call(this, event, handlers);
 437 
 438             // 先运行委托,如果阻止了冒泡就停止循环
 439             i = 0;
 440             while ((matched = handlerQueue[i++]) && !event.isPropagationStopped()) {
 441                 event.currentTarget = matched.elem;
 442 
 443                 j = 0;
 444 
 445                 // 遍历当前元素的事件处理程序数组
 446                 while ((handleObj = matched.handlers[j++]) && !event.isImmediatePropagationStopped()) {
 447                     // 被触发的时间不能有命名空间或者有命名空间,且被绑定的事件是命名空间的一个子集
 448                     if (!event.namespace_re || event.namespace_re.test(handleObj.namespace)) {
 449                         event.handleObj = handleObj;
 450                         event.data = handleObj.data;
 451 
 452                         // 尝试通过事件特例触发handle方法,如果没有则触发handleObj的handler方法
 453                         // mouseenter/mouseleave事件特例就是使用了该handle方法, 
 454                         // 事件特例的handle方法就是相当于一个装饰者,
 455                         // 把handleObj.handler包装了起来
 456                         ret = ((jQuery.event.special[handleObj.origType] || {}).handle || handleObj.handler).apply(matched.elem, args);
 457 
 458                         // 如果ret有值且是false则阻止默认行为和冒泡
 459                         // 即return false的时候阻止默认行为和冒泡
 460                         if (ret !== undefined) {
 461                             if ((event.result = ret) === false) {
 462                                 event.preventDefault();
 463                                 event.stopPropagation();
 464                             }
 465                         }
 466                     }
 467                 }
 468             }
 469 
 470             // 运行postDispatch钩子方法
 471             if (special.postDispatch) {
 472                 special.postDispatch.call(this, event);
 473             }
 474 
 475             return event.result;
 476         },
 477         // 处理委托事件的方法,返回一个队列,队列中每个元素有当前元素和匹配到的handler
 478         handlers: function(event, handlers) {
 479             var sel, handleObj, matches, i,
 480                 handlerQueue = [],
 481                 delegateCount = handlers.delegateCount,
 482                 // 当前时间元素
 483                 cur = event.target;
 484 
 485             // 是否有委托
 486             if (delegateCount && cur.nodeType && (!event.button || event.type !== 'click')) {
 487                 // 遍历父辈元素,直到找到委托元素this
 488                 for (; cur != this; cur = cur.parentNode || this) {
 489                     // 确保是元素且未禁用或者非点击事件
 490                     if (cur.nodeType === 1 && (cur.disabled !== true || event.type !== 'click')) {
 491                         matches = [];
 492                         // 遍历被委托事件处理程序,handlers[i]为jq的handler对象
 493                         for (i = 0; i < delegateCount; i++) {
 494                             handleObj = handlers[i];
 495 
 496                             // 当前handler的选择器字符, 加空格字符串是为了防止和Object.prototype属性冲突
 497                             sel = handleObj.selector + ' ';
 498 
 499                             // matches[sel]保存着当前元素是否在受委托元素中的标记
 500                             if (matches[sel] === undefined) {
 501                                 matches[sel] = handleObj.needsContext ?
 502                                     jQuery(sel, this).index(cur) >= 0 :
 503                                     jQuery.find(sel, this, null, [cur]).length;
 504                             }
 505                             // 如果当前元素是在受委托元素中,则将当前handlerObj推入到matches数组中
 506                             if (matches[sel]) {
 507                                 matches.push(handleObj);
 508                             }
 509                         }
 510                         // 如果matches数组有内容,则将新对象推入handlerQueue队列中
 511                         // elem保存着当前元素,handlers这保存着当前元素匹配的handlers
 512                         if (matches.length) {
 513                             handlerQueue.push({
 514                                 elem: cur,
 515                                 handlers: matches
 516                             });
 517                         }
 518                     }
 519                 }
 520             }
 521 
 522             // 如果handlers还有剩余,把剩余的部分也推入到队列中
 523             if (delegateCount < handlers.length) {
 524                 handlerQueue.push({
 525                     elem: this,
 526                     handlers: handlers.slice(delegateCount)
 527                 });
 528             }
 529 
 530             return handlerQueue;
 531         },
 532         // 创建一个jq event对象,让其拥有和原始event一样的属性和值
 533         fix: function(event) {
 534             if (event[jQuery.expando]) {
 535                 return event;
 536             }
 537 
 538             var i, prop, copy,
 539                 type = event.type,
 540                 originalEvent = event,
 541                 fixHook = this.fixHooks[type];
 542 
 543             // 如果fixHook不存在判断是鼠标事件还是键盘事件再指向相应的钩子对象
 544             if (!fixHook) {
 545                 this.fixHooks[type] = fixHook =
 546                     rmouseEvent.test(type) ? this.mouseHooks :
 547                     rkeyEvent.test(type) ? this.keyHooks : {};
 548             }
 549             // fixHook是否有props属性,该值是一个数组,如果有则添加到jQuery.event.props中
 550             copy = fixHook.props ? this.props.concat(fixHook.props) : this.props;
 551             // 创建一个jQuery Event实例event,默认行为和冒泡fix
 552             event = new jQuery.Event(originalEvent);
 553 
 554             // 给jq event添加原始event对象的属性
 555             i = copy.length;
 556             while (i--) {
 557                 prop = copy[i];
 558                 event[prop] = originalEvent[prop];
 559             }
 560 
 561             // Support: IE<9
 562             if (!event.target) {
 563                 event.target = originalEvent.srcElement || document;
 564             }
 565 
 566             // Support: Chrome 23+, Safari?
 567             if (event.target.nodeType === 3) {
 568                 event.target = event.target.parentNode;
 569             }
 570 
 571             // Support: IE<9
 572             event.metaKey = !! event.metaKey;
 573 
 574             // 如果钩子对象有filter解决兼容方法,则返回filter后的event
 575             return fixHook.filter ? fixHook.filter(event, originalEvent) : event;
 576         },
 577         // event对象相关属性
 578         props: 'altKey bubbles cancelable ctrlKey currentTarget eventPhase metaKey relatedTarget shiftKey target timeStamp view which'.split(' '),
 579         // 后续要用的
 580         fixHooks: {},
 581         // keyEvent钩子
 582         keyHooks: {
 583             props: 'char charCode key keyCode'.split(' '),
 584             filter: function(event, original) {
 585                 if (event.which == null) {
 586                     event.which = original.charCode != null ? original.charCode : original.keyCode;
 587                 }
 588 
 589                 return event;
 590             }
 591         },
 592         /*
 593          mouseEvent钩子,处理有关鼠标事件的兼容性.
 594          original为原始event对象,event则为jQuery的event对象
 595          */
 596         mouseHooks: {
 597             props: 'button buttons clientX clientY fromElement offsetX offsetY pageX pageY scrennX screenY toElement'.split(' '),
 598             filter: function(event, original) {
 599                 var body, eventDoc, doc,
 600                     button = original.button,
 601                     fromElement = original.fromElement;
 602 
 603                 if (event.pageX == null && original.clientX != null) {
 604                     eventDoc = event.target.ownerDocument || document;
 605                     doc = eventDoc.documentElement;
 606                     body = eventDoc.body;
 607 
 608                     event.pageX = original.clientX + (doc && doc.scrollLeft || body && body.scrollLeft || 0) - (doc && doc.clientLeft || body && body.clientLeft || 0);
 609                     event.pageY = original.clientY + (doc && doc.scrollTop || body && body.scrollTop || 0) - (doc && doc.clientTop || body && body.clientTop || 0);
 610                 }
 611 
 612                 if (!event.relatedTarget && fromElement) {
 613                     event.relatedTarget = fromElement === event.target ? original.toElement : fromElement;
 614                 }
 615 
 616                 // 为点击事件添加which属性, 1 === left;2 === middle; 3 === right
 617                 // 这里没使用button作为属性
 618                 if (!event.which && button !== undefined) {
 619                     event.which = (button & 1 ? 1 : (button & 2 ? 3 : (button & 4 ? 2 : 0)));
 620                 }
 621 
 622                 return event;
 623             }
 624         },
 625         /*
 626          用来处理各事件里的特殊例子
 627          */
 628         special: {
 629             load: {
 630                 // 阻止image的load事件冒泡到window.load
 631                 noBubble: true
 632             },
 633             click: {
 634                 // For checkbox, fire native event so checked state will be right
 635                 trigger: function() {
 636                     if (jQuery.nodeName(this, 'input') && this.type === 'checkbox' && this.click) {
 637                         this.click();
 638                         return false;
 639                     }
 640                 }
 641             },
 642             focus: {
 643                 trigger: function() {
 644                     if (this !== document.activeElement && this.focus) {
 645                         try {
 646                             this.focus();
 647                             return false;
 648                         } catch (e) {}
 649                     }
 650                 },
 651                 delegateType: 'focusin'
 652             },
 653             blur: {
 654                 trigger: function() {
 655                     if (this === document.activeElement && this.blur) {
 656                         this.blur();
 657                         return false;
 658                     }
 659                 },
 660                 delegateType: 'focusout'
 661             },
 662             beforeunload: {
 663                 postDispatch: function(event) {
 664                     // Even when returnValue equals to undefined Firefox will still show alert
 665                     if (event.result !== undefined) {
 666                         event.originalEvent.returnValue = event.result;
 667                     }
 668                 }
 669             }
 670         },
 671         // 模拟一个event
 672         simulate: function(type, elem, event, bubble) {
 673             var e = jQuery.extend(new jQuery.Event(),
 674                 event, {
 675                     type: type,
 676                     isSimulated: true,
 677                     originalEvent: {}
 678                 });
 679             if (bubble) {
 680                 jQuery.event.trigger(e, null, elem);
 681             } else {
 682                 jQuery.event.dispatch.call(elem, e);
 683             }
 684             if (e.isDefaultPrevented()) {
 685                 event.preventDefault();
 686             }
 687         }
 688     };
 689 
 690     // 跨浏览器删除事件
 691     jQuery.removeEvent = document.removeEventListener ?
 692         function(elem, type, handle) {
 693             if (elem.removeEventListener) {
 694                 elem.removeEventListener(type, handle, false);
 695             }
 696     } :
 697         function(elem, type, handle) {
 698             var name = 'on' + type;
 699 
 700             if (elem.detachEvent) {
 701                 if (typeof elem[name] === core_strundefined) {
 702                     elem[name] = null;
 703                 }
 704 
 705                 elem.detachEvent(name, handle);
 706             }
 707     };
 708 
 709     /*
 710      Event类用来解决阻止默认行为和事件冒泡兼容的类,src为原始event对象,props则是event的一些预配置项
 711      */
 712     jQuery.Event = function(src, props) {
 713         if (!(this instanceof jQuery.Event)) {
 714             return new jQuery.Event(src, props);
 715         }
 716 
 717         if (src && src.type) {
 718             this.originalEvent = src;
 719             this.type = src.type;
 720 
 721             this.isDefaultPrevented = (src.defaultPrevented || src.returnValue === false || src.getPreventDefault && src.getPreventDefault()) ? returnTrue : returnFalse;
 722         } else {
 723             this.type = src;
 724         }
 725 
 726         if (props) {
 727             jQuery.extend(this, props);
 728         }
 729 
 730         this.timeStamp = src && src.timeStamp || jQuery.now();
 731 
 732         this[jQuery.expando] = true;
 733     };
 734 
 735     jQuery.Event.prototype = {
 736         isDefaultPrevented: returnFalse,
 737         isPropagationStopped: returnFalse,
 738         isImmediatePropagationStopped: returnFalse,
 739 
 740         preventDefault: function() {
 741             var e = this.originalEvent;
 742 
 743             this.isDefaultPrevented = returnTrue;
 744             if (!e) {
 745                 return;
 746             }
 747 
 748             if (e.preventDefault) {
 749                 e.preventDefault();
 750             } else {
 751                 e.returnValue = false;
 752             }
 753         },
 754         stopPropagation: function() {
 755             var e = this.originalEvent;
 756 
 757             this.isPropagationStopped = returnTrue;
 758             if (!e) {
 759                 return;
 760             }
 761             if (e.stopPropagation) {
 762                 e.stopPropagation();
 763             }
 764             e.cancelBubble = true;
 765         },
 766         stopImmediatePropagation: function() {
 767             this.isImmediatePropagationStopped = returnTrue;
 768             this.stopPropagation();
 769         }
 770     };
 771 
 772     jQuery.each({
 773         mouseenter: 'mouseover',
 774         mouseleave: 'mouseout'
 775     }, function(orig, fix) {
 776         jQuery.event.special[orig] = {
 777             delegateType: fix,
 778             bindType: fix,
 779 
 780             handle: function(event) {
 781                 var ret,
 782                     target = this,
 783                     related = event.relatedTarget,
 784                     handleObj = event.handleObj;
 785 
 786                 // For mousenter/leave call the handler if related is outside the target.
 787                 // NB: No relatedTarget if the mouse left/entered the browser window
 788                 // 确保相关元素是在目标元素的外面,
 789                 // 没有相关元素指的是移到/移出浏览器外
 790                 if (!related || (related !== target && !jQuery.contains(target, related))) {
 791                     event.type = handleObj.origType;
 792                     ret = handleObj.handler.apply(this, arguments);
 793                     event.type = fix;
 794                 }
 795                 return ret;
 796             }
 797         };
 798     });
 799 
 800     // IE submit 委托
 801     if (!jQuery.support.submitBubbles) {
 802         jQuery.event.special.submit = {
 803             setup: function() {
 804                 if (jQuery.nodeName(this, 'form')) {
 805                     return false;
 806                 }
 807 
 808                 // Lazy-add a submit handler when a descendant form may potentially be submitted
 809                 jQuery.event.add(this, 'click._submit keypress._submit', function(e) {
 810                     // Node name check avoids a VML-related crash in IE (#9807)
 811                     var elem = e.target,
 812                         form = jQuery.nodeName(elem, 'input') || jQuery.nodeName(elem, 'button') ? elem.form : undefined;
 813                     if (form && !jQuery._data(form, 'submitBubbles')) {
 814                         jQuery.event.add(form, 'submit._submit', function(event) {
 815                             event._submit_bubble = true;
 816                         });
 817                         jQuery._data(form, 'submitBubbles', true);
 818                     }
 819                 });
 820                 // return undefined since we don't need an event listener
 821             },
 822             postDispatch: function(event) {
 823                 // If form was submitted by the user, bubble the event up the tree
 824                 if (event._submit_bubble) {
 825                     delete event._submit_bubble;
 826                     if (this.parentNode && !event.isTrigger) {
 827                         jQuery.event.simulate('submit', this.parentNode, event, true);
 828                     }
 829                 }
 830             },
 831             teardown: function() {
 832                 // Only need this for delegated form submit events
 833                 if (jQuery.nodeName(this, 'form')) {
 834                     return false;
 835                 }
 836 
 837                 // Remove delegated handlers; cleanData eventually reaps submit handlers attached above
 838                 jQuery.event.remove(this, '._submit');
 839             }
 840         };
 841     }
 842 
 843     // IE change delegation and checkbox/radio fix
 844     if (!jQuery.support.changeBubbles) {
 845 
 846         jQuery.event.special.change = {
 847 
 848             setup: function() {
 849 
 850                 if (rformElems.test(this.nodeName)) {
 851                     // IE doesn't fire change on a check/radio until blur; trigger it on click
 852                     // after a propertychange. Eat the blur-change in special.change.handle.
 853                     // This still fires onchange a second time for check/radio after blur.
 854                     if (this.type === "checkbox" || this.type === "radio") {
 855                         jQuery.event.add(this, "propertychange._change", function(event) {
 856                             if (event.originalEvent.propertyName === "checked") {
 857                                 this._just_changed = true;
 858                             }
 859                         });
 860                         jQuery.event.add(this, "click._change", function(event) {
 861                             if (this._just_changed && !event.isTrigger) {
 862                                 this._just_changed = false;
 863                             }
 864                             // Allow triggered, simulated change events (#11500)
 865                             jQuery.event.simulate("change", this, event, true);
 866                         });
 867                     }
 868                     return false;
 869                 }
 870                 // Delegated event; lazy-add a change handler on descendant inputs
 871                 jQuery.event.add(this, "beforeactivate._change", function(e) {
 872                     var elem = e.target;
 873 
 874                     if (rformElems.test(elem.nodeName) && !jQuery._data(elem, "changeBubbles")) {
 875                         jQuery.event.add(elem, "change._change", function(event) {
 876                             if (this.parentNode && !event.isSimulated && !event.isTrigger) {
 877                                 jQuery.event.simulate("change", this.parentNode, event, true);
 878                             }
 879                         });
 880                         jQuery._data(elem, "changeBubbles", true);
 881                     }
 882                 });
 883             },
 884 
 885             handle: function(event) {
 886                 var elem = event.target;
 887 
 888                 // Swallow native change events from checkbox/radio, we already triggered them above
 889                 if (this !== elem || event.isSimulated || event.isTrigger || (elem.type !== "radio" && elem.type !== "checkbox")) {
 890                     return event.handleObj.handler.apply(this, arguments);
 891                 }
 892             },
 893 
 894             teardown: function() {
 895                 jQuery.event.remove(this, "._change");
 896 
 897                 return !rformElems.test(this.nodeName);
 898             }
 899         };
 900     }
 901 
 902     // Create "bubbling" focus and blur events
 903     if (!jQuery.support.focusinBubbles) {
 904         jQuery.each({
 905             focus: "focusin",
 906             blur: "focusout"
 907         }, function(orig, fix) {
 908 
 909             // Attach a single capturing handler while someone wants focusin/focusout
 910             var attaches = 0,
 911                 handler = function(event) {
 912                     jQuery.event.simulate(fix, event.target, jQuery.event.fix(event), true);
 913                 };
 914 
 915             jQuery.event.special[fix] = {
 916                 setup: function() {
 917                     if (attaches++ === 0) {
 918                         document.addEventListener(orig, handler, true);
 919                     }
 920                 },
 921                 teardown: function() {
 922                     if (--attaches === 0) {
 923                         document.removeEventListener(orig, handler, true);
 924                     }
 925                 }
 926             };
 927         });
 928     }
 929 
 930     jQuery.fn.extend({
 931         on: function(types, selector, data, fn, /*INTERNAL*/ one) {
 932             var type, origFn;
 933 
 934             // 添加多个事件注册
 935             if (typeof types === "object") {
 936                 // ( types-Object, selector, data )
 937                 if (typeof selector !== "string") {
 938                     // ( types-Object, data )
 939                     data = data || selector;
 940                     selector = undefined;
 941                 }
 942                 // 为每个事件迭代
 943                 for (type in types) {
 944                     this.on(type, selector, data, types[type], one);
 945                 }
 946                 return this;
 947             }
 948 
 949             // 如果data和fn都为空,则将selector赋值给fn,
 950             if (data == null && fn == null) {
 951                 // ( types, fn )
 952                 fn = selector;
 953                 data = selector = undefined;
 954             } else if (fn == null) {
 955                 if (typeof selector === "string") {
 956                     // ( types, selector, fn )
 957                     fn = data;
 958                     data = undefined;
 959                 } else {
 960                     // ( types, data, fn )
 961                     fn = data;
 962                     data = selector;
 963                     selector = undefined;
 964                 }
 965             }
 966             if (fn === false) {
 967                 fn = returnFalse;
 968             } else if (!fn) {
 969                 return this;
 970             }
 971 
 972             // 如果只是一次性事件,则将fn从新包装
 973             if (one === 1) {
 974                 origFn = fn;
 975                 fn = function(event) {
 976                     // 这里使用空的jq对象来解除事件绑定信息,
 977                     // 具体定位是通过event.handleObj和目标元素event.delegateTarget
 978                     jQuery().off(event);
 979                     // 执行原始的fn函数
 980                     return origFn.apply(this, arguments);
 981                 };
 982                 // Use same guid so caller can remove using origFn
 983                 // 备忘信息
 984                 fn.guid = origFn.guid || (origFn.guid = jQuery.guid++);
 985             }
 986             // 统一调用jQuery.event.add方法添加事件处理
 987             return this.each(function() {
 988                 jQuery.event.add(this, types, fn, data, selector);
 989             });
 990         },
 991         one: function(types, selector, data, fn) {
 992             return this.on(types, selector, data, fn, 1);
 993         },
 994         off: function(types, selector, fn) {
 995             var handleObj, type;
 996             // 当传递的types是jQuery创建的event对象时
 997             if (types && types.preventDefault && types.handleObj) {
 998                 // ( event )  dispatched jQuery.Event
 999                 handleObj = types.handleObj;
1000                 jQuery(types.delegateTarget).off(
1001                     handleObj.namespace ? handleObj.origType + "." + handleObj.namespace : handleObj.origType,
1002                     handleObj.selector,
1003                     handleObj.handler
1004                 );
1005                 return this;
1006             }
1007             // 当types是对象,遍历递归
1008             if (typeof types === "object") {
1009                 // ( types-object [, selector] )
1010                 for (type in types) {
1011                     this.off(type, selector, types[type]);
1012                 }
1013                 return this;
1014             }
1015             if (selector === false || typeof selector === "function") {
1016                 // ( types [, fn] )
1017                 fn = selector;
1018                 selector = undefined;
1019             }
1020             if (fn === false) {
1021                 fn = returnFalse;
1022             }
1023             // 统一调用jQuery.event.remove移除事件处理程序及相关信息
1024             return this.each(function() {
1025                 jQuery.event.remove(this, types, fn, selector);
1026             });
1027         },
1028         bind: function(types, data, fn) {
1029             return this.on(types, null, data, fn);
1030         },
1031         unbind: function(types, fn) {
1032             return this.off(types, null, fn);
1033         },
1034         delegate: function(selector, types, data, fn) {
1035             return this.on(types, selector, data, fn);
1036         },
1037         undelegate: function(selector, types, fn) {
1038             // ( namespace ) or ( selector, types [, fn] )
1039             return arguments.length === 1 ? this.off(selector, "**") : this.off(types, selector || "**", fn);
1040         },
1041         trigger: function(type, data) {
1042             return this.each(function() {
1043                 jQuery.event.trigger(type, data, this);
1044             });
1045         },
1046         triggerHandler: function(type, data) {
1047             var elem = this[0];
1048             if (elem) {
1049                 return jQuery.event.trigger(type, data, elem, true);
1050             }
1051         }
1052     });

 

posted @ 2013-09-24 20:57  LukeLin  阅读(588)  评论(0编辑  收藏  举报