在處理 DOM 結構時,常需要判斷兩個節點之間的包含關係或前後順序。contains 與 compareDocumentPosition 是兩種常見方式,前者直覺,後者表達能力更完整。
contains 最早常見於 IE,用來判斷某節點是否位於另一元素內。注意若兩者相同,部分實作會回傳 true,但語意上元素不應包含自己,因此封裝時通常會排除相同節點。
function contains(a, b) {
return a.contains ? a != b && a.contains(b) : !!(a.compareDocumentPosition(b) & 16);
}DOM Level 3 的 compareDocumentPosition 可回傳位元碼,表示兩個節點的相對位置。常見位元意義如下:
例如父節點包含子節點時,結果可能同時包含 4 與 16,相加後為 20。
var parent = document.getElementById('a');
var child = document.getElementById('b');
var result = parent.compareDocumentPosition(child);IE 沒有 compareDocumentPosition,但可用 contains 與 sourceIndex 模擬。sourceIndex 可代表元素在文件中的順序,若為 -1 表示不在目前文件。
function comparePosition(a, b) {
if (a.compareDocumentPosition) {
return a.compareDocumentPosition(b);
}
if (a.contains) {
return (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);
}
return 0;
}這類判斷常用於排序 DOM 節點、建立目錄或最佳化選擇器查詢。Safari 若缺少 sourceIndex,相容性會較有限。