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()
コンストラクターも使用できます。
インスタンスプロパティ
継承しているプロパティはありません。
Range.collapsed
読取専用-
論理値で、範囲の始点と終点が同じ位置にあるか否かを示します。
Range.commonAncestorContainer
読取専用-
startContainer
とendContainer
をともに含む、最も深いNode
を返します。 Range.endContainer
読取専用-
Range
の終点を含むNode
を返します。 Range.endOffset
読取専用-
endContainer
の中でのRange
の終点の位置を示す数字を返します。 Range.startContainer
読取専用-
Range
の始点を含むNode
を返します。 Range.startOffset
読取専用-
startContainer
の中でのRange
の始点の位置を示す数字を返します。
コンストラクター
インスタンスメソッド
継承しているメソッドはありません。
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
の内容を文字列として返します。
仕様書
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