StaticRange: StaticRange() コンストラクター
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
ノードです。
仕様書
Specification |
---|
DOM Standard # ref-for-dom-staticrange-staticrange① |
ブラウザーの互換性
BCD tables only load in the browser