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.

Die DOM StaticRange-Schnittstelle erweitert AbstractRange, um eine Methode bereitzustellen, mit der ein Inhaltsbereich im DOM angegeben werden kann, dessen Inhalte nicht aktualisiert werden, um Änderungen im DOM-Baum widerzuspiegeln.

Diese Schnittstelle bietet denselben Satz von Eigenschaften und Methoden wie AbstractRange.

AbstractRange und StaticRange sind nicht von Web-Workern aus verfügbar.

AbstractRange StaticRange

Konstruktor

StaticRange()

Erstellt ein neues StaticRange-Objekt unter Verwendung von Optionen, die die Standardwerte für seine Eigenschaften angeben.

Instanz-Eigenschaften

Die unten aufgeführten Eigenschaften werden von ihrer übergeordneten Schnittstelle AbstractRange geerbt.

StaticRange.collapsed Schreibgeschützt

Gibt einen booleschen Wert zurück, der true ist, wenn die Start- und Endposition des Bereichs identisch sind, was zu einem Bereich der Länge 0 führt.

StaticRange.endContainer Schreibgeschützt

Gibt den DOM-Node zurück, der den Endpunkt des Bereichs enthält. Der Offset in das Knoten, an dem die Endposition liegt, wird durch endOffset angegeben.

StaticRange.endOffset Schreibgeschützt

Gibt eine Ganzzahl zurück, die den Offset im Knoten angibt, der durch endContainer gegeben ist, wo das letzte Zeichen des Bereichs gefunden wird.

StaticRange.startContainer Schreibgeschützt

Gibt den DOM-Node zurück, der den Startpunkt des Bereichs enthält (dieser wird wiederum durch startOffset identifiziert).

StaticRange.startOffset Schreibgeschützt

Gibt eine Ganzzahl zurück, die den Offset im Knoten angibt, der durch startContainer angegeben ist, an dem das erste Zeichen des Bereichs gefunden wird.

Nutzungshinweise

Ein DOM-Bereich spezifiziert einen Inhaltsspanne in einem Dokument, der möglicherweise innerhalb eines Knotens (oder Elements) beginnt und in einem anderen endet. Im Gegensatz zu einem Range stellt ein StaticRange einen Bereich dar, der in der Zeit fixiert ist; er ändert sich nicht, um zu versuchen, den gleichen Inhalt innerhalb zu halten, während sich das Dokument ändert. Wenn Änderungen im DOM vorgenommen werden, können sich die tatsächlichen Daten, die innerhalb des durch einen StaticRange spezifizierten Bereichs enthalten sind, ändern. Dadurch kann der User Agent viel unnötige Arbeit vermeiden, wenn die Web-App oder die Website keinen live-aktualisierten Bereich benötigt.

Spezifikationen

Specification
DOM
# interface-staticrange

Browser-Kompatibilität

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
StaticRange
StaticRange() constructor
collapsed
endContainer
endOffset
startContainer
startOffset

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
See implementation notes.

Siehe auch

  • Live-aktualisierender Inhaltsbereich innerhalb des DOM: Range
  • AbstractRange, die abstrakte Schnittstelle, von der alle Bereiche abgeleitet sind