StaticRange: StaticRange() コンストラクター
Baseline
広く利用可能
この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。2021年4月以降、すべてのブラウザーで利用可能です。
StaticRange() コンストラクターは、 DOM 内のコンテンツの範囲を表す新しい StaticRange オブジェクトを作成します。
このコンストラクターは、範囲の開始位置と終了位置を示すプロパティと、範囲が折りたたまれている(つまり空である)かどうかを示す論理値を含みます。
構文
js
new StaticRange(rangeSpec)
引数
rangeSpec-
要求される
rangeSpec引数は、以下の 4 つのプロパティを格納したオブジェクトです。startContainer-
範囲の始点がある
Nodeです。 startOffset-
範囲の最初の文字が見つかる開始ノード内のオフセットです。
endContainer-
範囲の終点がある
Nodeです。 endOffset-
endOffsetで示される、ノード内で範囲内の最後の文字がある位置のオフセットです。
返値
rangeSpec オブジェクトで指定された値で初期化された新しい StaticRange オブジェクト。
例外
InvalidNodeTypeError-
startContainerとendContainerのどちらか、または両方が範囲を含めることができないノード種別である場合にDOMExceptionが発生します。これらのノード種別はNode.DOCUMENT_TYPE_NODE(例えば、HTMLのdoctypeプリアンブルを使用して識別された DTD から派生したDocumentTypeノードを表します)と DOM 上の要素の属性を記述するAttrノードです。
仕様書
| 仕様書 |
|---|
| DOM> # ref-for-dom-staticrange-staticrange①> |