StaticRange: StaticRange() コンストラクター

StaticRange() コンストラクターは、 DOM 内のコンテンツの範囲を表す新しい StaticRange オブジェクトを作成します。

このコンストラクターは、範囲の開始位置と終了位置を示すプロパティと、範囲が折りたたまれている(つまり空である)かどうかを示す論理値を含みます。

構文

js
new StaticRange(rangeSpec)

引数

rangeSpec

要求される rangeSpec 引数は、以下の 4 つのプロパティを格納したオブジェクトです。

startContainer

範囲の始点がある Node です。

startOffset

範囲の最初の文字が見つかる開始ノード内のオフセットです。

endContainer

範囲の終点がある Node です。

endOffset

endOffset で示される、ノード内で範囲内の最後の文字がある位置のオフセットです。

返値

rangeSpec オブジェクトで指定された値で初期化された新しい StaticRange オブジェクト。

例外

InvalidNodeTypeError

startContainerendContainer のどちらか、または両方が範囲を含めることができないノード種別である場合に DOMException が発生します。これらのノード種別は Node.DOCUMENT_TYPE_NODE (例えば、HTMLの doctype プリアンブルを使用して識別された DTD から派生した DocumentType ノードを表します)と DOM 上の要素の属性を記述する Attr ノードです。

仕様書

Specification
DOM Standard
# ref-for-dom-staticrange-staticrange①

ブラウザーの互換性

BCD tables only load in the browser