Range

Range インターフェイスとは document の断片で、ある document 中のノードやテキストノードの一部を含むことのできるものです。

range は document オブジェクトの createRange() メソッドにより生成することができます。また、Selection オブジェクトの getRangeAt() メソッドや Document オブジェクトの caretRangeFromPoint() メソッドにより取得することもできます。

さらに、Range() コンストラクターも使用できます。

プロパティ

継承しているプロパティはありません。

range.collapsed 読取専用

range の始点と終点が同じ位置にあるか否かを示す Boolean を返す

range.commonAncestorContainer 読取専用

startContainer と endContainer をともに含む、最も深い Node を返す

range.endContainer 読取専用

Range の終点を含む Node を返す

range.endOffset 読取専用

endContainer の中での Range の終点の位置を示す数字を返す

range.startContainer 読取専用

Range の始点を含む Node を返す

range.startOffset 読取専用

startContainer の中での Range の始点の位置を示す数字を返す

コンストラクター

Range()

始点および終点がグローバルな Document である Range オブジェクトを返します。

メソッド

継承しているメソッドはありません。

range.setStart()

Range の始点を設定

range.setEnd()

Range の終点を設定

range.setStartBefore()

他の Node を基準に Range の始点を設定

range.setStartAfter()

他の Node を基準に Range の始点を設定

range.setEndBefore()

他の Node を基準に Range の終点を設定

range.setEndAfter()

他の Node を基準に Range の終点を設定

range.selectNode()

Range を、ある Node とその内容を含むように設定

range.selectNodeContents()

Range を、ある Node の内容を含むように設定

range.collapse()

Range をその端点の一方へ折りたたむ

range.cloneContents()

Range の中身をコピーした DocumentFragment を返す

range.deleteContents()

Range の中身を Document から削除

range.extractContents()

Range の中身をドキュメントツリーから DocumentFragment に移動

range.insertNode()

Range の始点に Node を挿入

range.surroundContents()

Range の中身を新しい Node の中に移動

range.compareBoundaryPoints()

2 つの Range の端点の位置を比較

range.cloneRange()

元の Range と同じ端点を持つ Range オブジェクトを返す

range.detach()

パフォーマンスを改善するために、 Range を使用状態から開放

range.toString()

Range の内容を文字列として返す

range.compareNode()

Node が range の前、後、中、外のうちのいずれの場所にあるかを示す定数を返す

range.comparePoint()

指定された点が Range の前、中、後のうちのいずれの場所にあるかを -1、0、1 で示す

range.createContextualFragment()

渡された文字列から生成した DocumentFragment を返す

Range.getBoundingClientRect()

Range の内容の全体に結びつく DOMRect オブジェクトを返します。これは、range.getClientRects() が返すすべての長方形の集合体です。

Range.getClientRects()

Range 内のすべての要素について、Element.getClientRects() の結果をまとめた DOMRect オブジェクトのリストを返します。

range.intersectsNode()

指定ノードの範囲が Range と交差するか否かを示す boolean を返す

range.isPointInRange()

与えられた点が Range の中にあるか否かを示す boolean を返す

仕様

ブラウザー実装状況

関連情報

• DOM インターフェイスの索引