這是一篇很不錯的文章,出自 PPK 兩年前之手,文中說明了 contains() 與 compareDocumentPosition() 兩個方法在各自瀏覽器上的運作方式。自那時起,我便對這些方法做了大量研究,也在許多場合使用過它們。在很多任務中——特別是有關結構抽象的 DOM 選擇器——它們都被證明非常有用。
這個方法最早用於 IE,用來判斷某個 DOM 節點是否包含於另一個 DOM 元素之中。當你想優化 CSS 選擇器的遍歷(例如「#id1 #id2」)時,它很有用:你可以用 getElementById 取得元素,再用 .contains() 確認 #id1 是否真的包含 #id2。要注意的是,若 DOM 節點與 DOM 元素相同,.contains() 會回傳 true,雖然一個元素並不能包含自己。以下是一個可跨 Internet Explorer、Firefox、Opera 與 Safari 運作的簡易包裝:
function contains(a, b) {
return a.contains ? a != b && a.contains(b) : !!(a.compareDocumentPosition(arg) & 16);
}
這個方法是 DOM Level 3 規範的一部分,能讓你判斷兩個 DOM 節點之間的相對位置,比 .contains() 更強大。它的一個可能應用,是把 DOM 節點排序成精確的順序。呼叫它時,會回傳一個位元碼(Bit)——把多重資訊壓縮進一個簡單的數字裡(0 或 1),你最終會打開/關閉個別位數,組合出最終結果。
以下是 compareDocumentPosition 可能回傳的資訊:
舉例來說:
<div id="a">
<div id="b"></div>
</div>
<script>
alert( document.getElementById("a").compareDocumentPosition(document.getElementById("b")) == 20);
</script>
當節點 A 包含節點 B(16)且在 B 之前(4),最後結果就是 20。若把位元的變化攤開來看會更好懂:000100 (4) + 010000 (16) = 010100 (20)。這無疑有助於理解這個最令人困惑的 DOM API 方法之一,而它的價值也當之無愧。
目前 DOMNode.compareDocumentPosition 已在 Firefox 與 Opera 中可用,但我們也能用一些技巧在 IE 中模擬它:
// Compare Position - MIT Licensed, John Resig
function comparePosition(a, b){
return a.compareDocumentPosition ?
a.compareDocumentPosition(b) :
a.contains ?
( a != b && a.contains(b) && 16 ) |
( a != b && b.contains(a) && 8 ) |
( a.sourceIndex >= 0 && b.sourceIndex >= 0 ?
( a.sourceIndex < b.sourceIndex && 4 ) |
( a.sourceIndex > b.sourceIndex && 2 ) :
1 ) :
0;
}
IE 提供了幾個可用的方法與屬性:先用 .contains() 取得「包含(16)或被包含(8)」的結果;IE 還有 .sourceIndex 屬性,對應每個元素在文件中的位置(例如 document.documentElement.sourceIndex == 0),有了它,就能完成「在前面(2)」與「在後面(4)」的判斷。若元素不在當前文件,.sourceIndex 等於 -1,對應結果 1;最後經推斷,若元素等於自己,則回傳空的位元碼 0。這個函式可在 IE、Firefox 與 Opera 中運作,但在 Safari 中只有 contains() 而無 sourceIndex,功能殘缺,除了包含(16)與被包含(8),其餘多回傳 1(代表斷開)。
PPK 曾提供一個很棒的例子,展示如何透過建立 getElementsByTagNames 方法來運用這項新功能。改編後如下:
// Original by PPK quirksmode.org
function getElementsByTagNames(list, elem) {
elem = elem || document;
var tagNames = list.split(','), results = [];
for ( var i = 0; i < tagNames.length; i++ ) {
var tags = elem.getElementsByTagName( tagNames[i] );
for ( var j = 0; j < tags.length; j++ )
results.push( tags[j] );
}
return results.sort(function(a, b){
return 3 - (comparePosition(a, b) & 6);
});
}
現在我們就能用它來依序建立站點的目錄了:getElementsByTagNames("h1, h2, h3");。雖然 Firefox 與 Opera 都已主動實作這個方法,我仍期待更多瀏覽器加入,共同向前推進。
(翻譯自〈Comparing Document Position〉)