[3] [CODE(DOMi)@en[[[Node]]]] [[オブジェクト]]の [DFN[[CODE(DOMm)@en[[[compareDocumentPosition]]]] [[メソッド]]]]は、2つの[[節点]]の[[文書順]]的な意味での関係を返します。

* 仕様書

- [1] [CITE@en-US[Web DOM Core]]
<http://dvcs.w3.org/hg/domcore/raw-file/tip/Overview.html#dom-node-comparedocumentposition>
- [2] [CITE@en-US[Document Object Model Core]]
<http://www.w3.org/TR/DOM-Level-3-Core/core.html#Node3-compareDocumentPosition>
- [5] [CITE@en-US[Document Object Model XPath]] 
<http://www.w3.org/TR/DOM-Level-3-XPath/xpath.html#DocumentOrder>

[4] 現時点では [[Web DOM Core]] には存在することだけで実質的な規定がまだされていません。
[TIME[2010-12-31T06:40:47.000Z]]

* 処理モデル

[8] この[[メソッド]]がよばれた[[節点]]を[DFN[[RUBYB[参照節点]@en[reference node]]]]とするとき、
[[参照節点]]と第1引数に与えられた[[節点]]についての[[文書]]中での位置を[[文書順]]に基づき調べて返します
[SRC[>>2]]。

* 文書順

[6] 「[[文書順]]」は通常の [[DOM]] [[節点]]に対しては [[DOM]] 仕様で定義されていますが、
[[DOM XPath]] 仕様では [CODE(DOMi)@en[[[XPathNamespace]]]] [[節点]]が追加されているため、
それに対応した拡張された「[[文書順]]」が定義されています。
[[DOM XPath]] に対応している場合には拡張された定義に基づき結果を返さなければなりません [SRC[>>5]]。

;; [7] という規定が2004年の [[DOM XPath]] 仕様では [CODE(DOMm)@en[[[compareTreePosition]]]] 
という現存しないメソッド名についてなされていますw