Node.compareDocumentPosition

ここへジャンプ:
  1. 概要
  2. 構文
  3. 注記
  4. 例
  5. 仕様
  6. 関連情報

概要

そのノードと別のノードの位置を比較し、結果となるビットマスクを返します。

構文

node.compareDocumentPosition( otherNode )
  • node : 比較元ノード
  • otherNode : node と比較する別ノード

注記

戻り値は以下の値を持つビットマスクの何れかとなります。

名称 値
DOCUMENT_POSITION_DISCONNECTED 1
DOCUMENT_POSITION_PRECEDING 2
DOCUMENT_POSITION_FOLLOWING 4
DOCUMENT_POSITION_CONTAINS 8
DOCUMENT_POSITION_CONTAINED_BY 16
DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC 32

例

var head = document.getElementsByTagName('head').item(0);

if ( head.compareDocumentPosition(document.body) & Node.DOCUMENT_POSITION_FOLLOWING ) {
  console.log("head 要素は body 要素より前に記述されています。");
} else {
  console.log("head 要素は body 要素の前に配置しなくてはなりません。");
}

注記: compareDocumentPosition の戻り値はビットマスクです。よって、有意な結果を得るには ビット演算子の "&" を用いなくてはならない点に注意して下さい。

仕様

仕様書 策定状況 コメント
DOM Level 3 Recommendation  
DOM Standard Living standard  

関連情報

ドキュメントのタグと貢献者

タグ: 
 このページの貢献者: fscholz, khalid32, ethertank
 最終更新者: khalid32,