DIV CSS 佈局教程網

讀 jQuery 原始碼(十二):事件刪除的核心 remove 方法
編輯:JQuery特效代碼     

remove 做的事與上一篇的 add 正好相反,而且處理分支幾乎一一對應——add 支援幾種綁定方式,remove 就有幾種拆除方式。這其實是很好的設計原則:對稱的 API 比容易忘、也比容易錯。

四個參數

elem:HTMLElement
types:事件名稱,如 'click' 或 'mouseover mouseout'
handler:要移除的回呼函式
pos:指定陣列位置

但內部處理沒這麼單純。

handler 為 false

if ( handler === false ) {
  handler = returnFalse;
}

與 add 完全一致,這是為了讓 unbind('click', false) 能對應到先前用 bind('click', false) 綁上的那顆。

types 其實可能是物件

// types is actually an event object here
if ( types && types.type ) {
  handler = types.handler;
  types = types.type;
}

這段值得停下來想一想。參數命名為 types(複數、暗示字串),卻在內部接受物件。這類「一個變數承載多種意義」的寫法在 jQuery 原始碼裡到處可見,某種程度上是 JavaScript 沒有型別檢查所促成的彈性,但也確實讓可讀性打了折扣。讀原始碼時,遇到這種段落不妨自己補上型別註解,會輕鬆很多。

三種移除情境

一、只傳 elem——移除該元素上的所有事件:

$('#id').unbind()

二、types 以點號開頭——移除該命名空間下的全部事件:

$('#id').unbind('.name')   // click.name、mouseover.name 等一併移除

對應程式碼:

// Unbind all events for the element
if ( !types || typeof types === "string" && types.charAt(0) === "." ) {
  types = types || "";
  for ( type in events ) {
    jQuery.event.remove( elem, type + types );
  }
  return;
}

注意這裡是遞迴呼叫:先把型別清空、只留命名空間,再對每個已註冊的事件名稱逐一重跑一次。

三、指定事件與 handler——走標準流程:

jQuery.event.remove(el, 'click', fn)

這次不會進入上面的遞迴,而是直接進 while 迴圈:

while ( (type = types[ i++ ]) ) {
  ...
}

標準流程的四個步驟

1. 判斷事件名稱是否帶命名空間(以點號區隔)。沒有命名空間,就刪除該事件名稱下的全部 handler;有命名空間,只刪該命名空間下的。

2. 取出事件陣列 eventType = events[type]。若沒傳 handler,表示清除這個事件類型的所有回呼;否則只移除指定的那一個(靠先前配好的 guid 比對)。

3. 特殊事件(如 live)另外處理,邏輯與 add 中的 special 分支對稱。

4. 最後善後:如果 events 已空,就把整個資料結構拆掉。

// Remove the expando if it's no longer used
if ( jQuery.isEmptyObject( events ) ) {
  var handle = elemData.handle;
  if ( handle ) {
    handle.elem = null;        // 對應 add 中暂存的 elem,避免 IE 記憶體洩漏
  }
  delete elemData.events;
  delete elemData.handle;
  if ( jQuery.isEmptyObject( elemData ) ) {
    jQuery.removeData( elem, undefined, true );
  }
}

handle.elem = null 這一行正是 add 中 eventHandle.elem = elem 的鏡像操作。兩處配對,才不會讓元素永遠被閉包引用著無法回收。

資料結構總覽

jQuery 事件管理資料結構圖:

讀完這兩篇的收穫

把 add 與 remove 放在一起讀,會發現 jQuery 的事件系統其實有很清楚的三層設計:最外層是 bind/unbind/delegate 這些語法糖,中間是 jQuery.event.add/remove 負責把 handler 整理進元素的資料槽,最底層才是真正的 addEventListener。中間這層的存在,換來了命名空間、事件代理、多 handler 排序與跨瀏覽器一致性。

實務上的啟示也很直接:動態建立又移除的元素,記得 unbind;在不要用 jQuery 事件的場合(例如為效能而直接掛原生監聽),jQuery 就管不到這些元素的清理,得自己負責。另外,jQuery 1.7 之後新增的 .on()/.off() 已成為推薦寫法,bind/unbind 在 3.0 中被標記為 Deprecated——原理相同,但新專案請用新 API。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved