Range
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()
非推奨 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