在處理 DOM 結構時,常需要判斷兩個節點之間的關係。contains 與 compareDocumentPosition 是兩個很實用的方法,但它們的語意與適用情境不同。
contains 最早常見於 IE,用來判斷某個節點是否被另一個元素包含。它在優化 CSS 選擇器、確認祖先關係時很有幫助。需要注意的是,有些實作會在節點與自身相同時回傳 true,但嚴格來說,一個元素不應包含自己。
compareDocumentPosition 屬於 DOM Level 3,能回傳兩個節點之間的位置關係。它比 contains 更細緻,可以判斷誰在前、誰在後、誰包含誰,甚至是否位於不同文件。
這個方法會回傳一個位元值,例如節點順序、包含關係與文件差異,會以不同數值表示。透過位元運算,可以組合出多種資訊。
舉例來說,若節點 A 包含節點 B,且 A 位於 B 之前,最終結果可能是 16 加上 4,也就是 20。這種設計看似複雜,卻能讓 DOM 排序與結構判斷更精準。
目前 Firefox 與 Opera 對 compareDocumentPosition 支援較好,而 IE 則可透過 contains 等方法補足。理解這兩個 API 的差異,能幫助前端開發者在處理動態選單、拖放排序與無障礙時更游刃有餘。