HTML DOM compareDocumentPosition()メソッド

元素对象参考手册要素オブジェクト

サンプル

現在のフィールドと指定されたフィールドのドキュメント内の位置を比較します:

var p1=document.getElementById("p1"); var p2=document.getElementById("p2"); p1.compareDocumentPosition(p2);

出力結果:

4

試してみる »

定義と使い方

compareDocumentPosition()このメソッドは、ドキュメントの順序に従って、現在のノードと指定されたノードのドキュメント内の位置を比較します。

上記のサンプルを見ると、戻り値は次のようになります:

1: 関係なし。これら2つのノードは同じドキュメントに属していません。

2: 最初のノード(P1)は2番目のノード(P2)の後にあります。

4: 最初のノード(P1)は2番目のノード(P2)の前に位置します。

8: 最初のノード(P1)は2番目のノード(P2)の内側にあります。

16: 2番目のノード(P2)は最初のノード(P1)の内側にあります。

32: 関係がない、または2つのノードが同じ要素の2つの属性である。

注意:戻り値は値の組み合わせになる場合があります。たとえば、20 が返された場合は、p2 が p1 の内部にあり(16)、かつ p1 が p2 の前にある(4)ことを意味します。


ブラウザサポート

Internet ExplorerFirefoxOperaGoogle ChromeSafari

すべての主要ブラウザが compareDocumentPosition() メソッドをサポートしています。

注意:Internet Explorer 8 およびそれ以前の IE バージョンはこのメソッドをサポートしていません。


構文

node.compareDocumentPosition(node)

パラメータ

パラメータ 型 説明
node Node object 必須。比較したい指定ノード。

戻り値

型 説明
Number 現在のノードと指定されたノードのドキュメント内の位置を比較します。

可能な戻り値:

上記のサンプルを見ると、戻り値は次のようになります:

1: 関係なし。これら2つのノードは同じドキュメントに属していません。

2: 最初のノード(P1)は2番目のノード(P2)の後にあります。

4: 最初のノード(P1)は2番目のノード(P2)の前に位置します。

8: 最初のノード(P1)は2番目のノード(P2)の内側にあります。

16: 2番目のノード(P2)は最初のノード(P1)の内側にあります。

32: 関係がない、または2つのノードが同じ要素の2つの属性である。

技術詳細

DOM バージョン Core Level 1 Node Object


元素对象参考手册要素オブジェクト

その他の拡張