Range
Range
インターフェイスは、ノードやテキストノードの部品を含むことができる文書の範囲を表します。
範囲は Document.createRange()
メソッドにより生成することができます。また、 Selection
オブジェクトの getRangeAt()
(en-US) メソッドや Document
オブジェクトの caretRangeFromPoint()
メソッドにより取得することもできます。
さらに、Range()
(en-US) コンストラクターも使用できます。
プロパティ
継承しているプロパティはありません。
Range.collapsed
読取専用-
論理値で、範囲の始点と終点が同じ位置にあるか否かを示します。
Range.commonAncestorContainer
読取専用-
startContainer
とendContainer
をともに含む、最も深い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) 非推奨 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