Range

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

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

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

AbstractRange (en-US) Range

プロパティ

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

Range.collapsed 読取専用

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

Range.commonAncestorContainer 読取専用

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

Range.endContainer 読取専用

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

Range.endOffset 読取専用

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

Range.startContainer 読取専用

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

Range.startOffset 読取専用

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

コンストラクター

Range() (en-US) Experimental

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

メソッド

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

Range.collapse() (en-US)

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

Range.compareBoundaryPoints() (en-US)

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

Range.compareNode() (en-US) Deprecated Non-standard

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

Range.comparePoint() (en-US) Experimental

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

Range.cloneContents()

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

Range.cloneRange() (en-US)

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

Range.createContextualFragment() (en-US) Experimental

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

Range.deleteContents() (en-US)

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

Range.detach() (en-US)

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

Range.extractContents() (en-US)

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

Range.getBoundingClientRect() (en-US) Experimental

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

Range.getClientRects() (en-US) Experimental

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

Range.isPointInRange() (en-US) Experimental

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

Range.insertNode() (en-US)

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

Range.intersectsNode() Experimental

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

Range.selectNode() (en-US)

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

Range.selectNodeContents() (en-US)

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

Range.setEnd() (en-US)

Range の終点を設定します。

Range.setStart()

Range の始点を設定します。

Range.setEndAfter() (en-US)

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

Range.setEndBefore() (en-US)

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

Range.setStartAfter() (en-US)

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

Range.setStartBefore() (en-US)

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

Range.surroundContents() (en-US)

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

Range.toString() (en-US)

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

関連情報