DOM

インターフェイス

StaticRange インターフェイス

→● MS（en-US）

このインターフェイスは AbstractRange を拡張して、DOMツリー内で発生する変更を反映するようにコンテンツが更新されない DOM 内のコンテンツの範囲を指定するメソッドを提供します。

このインターフェイスは、AbstractRange と同じプロパティとメソッドのセットを提供します。

AbstractRange と StaticRange は、Webワーカーからは利用できません。

コンストラクター

new StaticRange() ●

プロパティのデフォルト値を指定する StaticRangeInit ディクショナリを指定して、新しい StaticRange オブジェクトを作成します。

プロパティ

以下のプロパティは、その親インターフェイスである AbstractRange から継承されます。

StaticRange.collapsed 読取専用

範囲の開始位置と終了位置が同じで、範囲の長さが 0 の場合に true となる boolean 値を返します。

StaticRange.endContainer 読取専用

範囲の終点を含むDOMノードを返します。終了位置が配置されているノードへのオフセットは、endOffsetで示されます。

StaticRange.endOffset 読取専用

範囲の最後の文字が見つかった endContainer によって指定されたノードへのオフセットを示す整数値を返します。

StaticRange.startContainer 読取専用

範囲の開始点を含むDOMノードを返します（これは startOffset によって識別されます）。

StaticRange.startOffset 読取専用

範囲の最初の文字が配置されている startContainer で指定されたノードへのオフセットを示す整数値を返します。

使用上の注意

DOM 範囲は、ドキュメント内のコンテンツのスパンを指定します。1 つのノード（または要素）内で始まり、別のノード（または要素）内で終わる可能性があります。
範囲とは異なり、StaticRangeは、時間的に固定されている範囲を表します。ドキュメントの変更時に同じコンテンツを保持しようとしても変更されません。
DOMに変更が加えられた場合、StaticRange で指定された範囲内に含まれる実際のデータは変更される場合があります。これにより、ユーザーエージェントは、Web アプリまたはサイトがライブ更新範囲を必要としない場合に不要な多くの作業を回避できます。

テスト