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