Range

Baseline Widely available *

This feature is well established and works across many devices and browser versions. It’s been available across browsers since ⁨2015年7月⁩.

* Some parts of this feature may have varying levels of support.

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

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

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

コンストラクター

Range(): 先頭および末尾がグローバルな Document である Range オブジェクトを返します。

インスタンスプロパティ

親インターフェイスである AbstractRange から継承したプロパティもあります。

Range.commonAncestorContainer 読取専用: startContainer と endContainer をともに含む、最も深い Node を返します。

インスタンスメソッド

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

Range.collapse(): Range をその端点の一方へ折りたたみます。
Range.compareBoundaryPoints(): Range の端点を、他の Range の端点と比較します。
Range.compareNode() 非推奨; 非標準: 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 の内容を文字列として返します。