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

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.

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