Range

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since March 2017.

Range インターフェイスは、ノードやテキストノードの部品を含むことができる文書の範囲を表します。

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

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

AbstractRange Range

インスタンスプロパティ

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

Range.collapsed 読取専用

論理値で、範囲の始点と終点が同じ位置にあるか否かを示します。

Range.commonAncestorContainer 読取専用

startContainerendContainer をともに含む、最も深い Node を返します。

Range.endContainer 読取専用

Range の終点を含む Node を返します。

Range.endOffset 読取専用

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

Range.startContainer 読取専用

Range の始点を含む Node を返します。

Range.startOffset 読取専用

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

コンストラクター

Range()

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

インスタンスメソッド

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

Range.collapse()

Range をその端点の一方へ折りたたみます。

Range.compareBoundaryPoints()

Range の端点を、他の Range の端点と比較します。

Range.compareNode() 非推奨 Non-standard

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

Range.comparePoint()

この点が Range の前、中、後のうちのいずれの場所にあるかを示す -1、0、1 を返します。

Range.cloneContents()

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

Range.cloneRange()

元の Range と同じ端点を持つ複製された Range オブジェクトを返します。

Range.createContextualFragment()

渡されたコードの文字列から生成した DocumentFragment を返します。

Range.deleteContents()

Range の中身を Document から削除します。

Range.detach()

何もしません。互換性のために維持されています。

Range.extractContents()

Range の中身を文書ツリーから DocumentFragment へ移動します。

Range.getBoundingClientRect()

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

Range.getClientRects()

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

Range.isPointInRange()

与えられた点が Range の中にあるか否かを示す論理値を返します。

Range.insertNode()

Range の始点に Node を挿入します。

Range.intersectsNode()

指定ノードの範囲が Range と交差するか否かを示す論理値を返します。

Range.selectNode()

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

Range.selectNodeContents()

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

Range.setEnd()

Range の終点を設定します。

Range.setStart()

Range の始点を設定します。

Range.setEndAfter()

他の Node を基準に Range の終点を設定します。

Range.setEndBefore()

他の Node を基準に Range の終点を設定します。

Range.setStartAfter()

他の Node を基準に Range の始点を設定します。

Range.setStartBefore()

他の Node を基準に Range の始点を設定します。

Range.surroundContents()

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

Range.toString()

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

仕様書

Specification
DOM Standard
# interface-range
DOM Parsing and Serialization
# extensions-to-the-range-interface
CSSOM View Module
# extensions-to-the-range-interface

ブラウザーの互換性

BCD tables only load in the browser

関連情報