StaticRange
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
Nur lesbar-
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
Nur lesbar-
Gibt den DOM-
Node
zurück, der den Endpunkt des Bereichs enthält. Der Offset in das Knoten, an dem die Endposition liegt, wird durchendOffset
angegeben. StaticRange.endOffset
Nur lesbar-
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
Nur lesbar-
Gibt den DOM-
Node
zurück, der den Startpunkt des Bereichs enthält (dieser wird wiederum durchstartOffset
identifiziert). StaticRange.startOffset
Nur lesbar-
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