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.

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 Standard # interface-staticrange

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch

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