DIV CSS 佈局教程網

JS contains 方法:跨瀏覽器實作節點包含判斷
編輯:關於JavaScript     

判斷「某元素是否為另一個元素的後代」是很常見的需求——事件委派要先確認目標節點屬於哪個容器,彈出層點擊外部要關閉視窗,都用得到。IE 提供了 element.contains(),標準瀏覽器則提供 compareDocumentPosition(),兩者語意相近但介面完全不同,因此實務上需要寫一層相容封裝。

IE 風格:contains

IE 的 contains(arg) 直接回傳布林值,寫法直觀:

標準風格:compareDocumentPosition

Firefox 支援 compareDocumentPosition(),這是 W3C 制訂的方法,標準瀏覽器普遍支援。它的問題在於回傳的不是布林值,而是一組依位元累加的整數,需要搭配位元運算解讀:

  • 0:兩個節點一致
  • 1:節點位於不同文件(或其中一個不在文件中)
  • 2:節點 B 在節點 A 之前
  • 4:節點 A 在節點 B 之前
  • 8:節點 B 包含節點 A
  • 16:節點 A 包含節點 B
  • 32:瀏覽器私有用途

因此判斷包含關係,就是檢查結果是否含有 16 這個位元。

PPK 的相容封裝

PPK 提出的解法是:若環境中不存在 contains,就用 compareDocumentPosition 補一個上去。

if (window.Node && Node.prototype && !Node.prototype.contains) {
  Node.prototype.contains = function (arg) {
    return !!(this.compareDocumentPosition(arg) & 16);
  };
}

另有更精簡的寫法,利用減法與大於零的判斷達成同義效果:

if (!!window.find) {
  HTMLElement.prototype.contains = function (B) {
    return this.compareDocumentPosition(B) - 19 > 0;
  };
}

不污染原生原型的函式版

擴充原型雖然方便,卻有污染全域的疑慮。更保守的做法是寫成獨立函式,三條路徑依序降級:

// 2011.9.24 by 司徒正美
var contains = function (root, el) {
  if (root.compareDocumentPosition)
    return root === el || !!(root.compareDocumentPosition(el) & 16);
  if (root.contains && el.nodeType === 1) {
    return root.contains(el) && root !== el;
  }
  while ((el = el.parentNode))
    if (el === root) return true;
  return false;
}

這個版本有三個值得注意的地方。第一,先判斷 root === el,因為 contains 在部分實作中對「自身包含自身」的行為並不一致,而語意上通常希望排除這種情況。第二,IE 分支加上 nodeType === 1 的條件,避免對文字節點呼叫時出現非預期結果。第三,最後一條 while 迴圈是最通用的後路——沿 parentNode 上溯,只依賴 DOM 最基本的指標,任何環境都能跑。

今日狀態

Node.prototype.contains() 如今已被所有主流瀏覽器支援,compareDocumentPosition 也同樣是標準 API,因此上述相容程式碼主要具備歷史與教學價值。真正需要留意的反而是效能:在大型 DOM 上反覆呼叫 contains 並不便宜,若同一份判斷要在短時間內執行許多次,考慮改用 Element.closest() 以 CSS 選擇器一次定位,通常更直覺也更省。

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