判斷「某元素是否為另一個元素的後代」是很常見的需求——事件委派要先確認目標節點屬於哪個容器,彈出層點擊外部要關閉視窗,都用得到。IE 提供了 element.contains(),標準瀏覽器則提供 compareDocumentPosition(),兩者語意相近但介面完全不同,因此實務上需要寫一層相容封裝。
IE 的 contains(arg) 直接回傳布林值,寫法直觀:
Firefox 支援 compareDocumentPosition(),這是 W3C 制訂的方法,標準瀏覽器普遍支援。它的問題在於回傳的不是布林值,而是一組依位元累加的整數,需要搭配位元運算解讀:
因此判斷包含關係,就是檢查結果是否含有 16 這個位元。
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 選擇器一次定位,通常更直覺也更省。