StaticRange: StaticRange() Konstruktor
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.
Der StaticRange()-Konstruktor erstellt ein neues StaticRange-Objekt, das einen Abschnitt von Inhalten im DOM darstellt.
Dieser Konstruktor enthält Eigenschaften, die die Start- und Endpositionen des Bereichs identifizieren, sowie einen booleschen Wert, der angibt, ob der Bereich zusammengeklappt ist (das heißt, leer).
Syntax
new StaticRange(rangeSpec)
Parameter
rangeSpec-
Der erforderliche
rangeSpec-Parameter ist ein Objekt, das die folgenden vier Eigenschaften enthält:startContainer-
Der
Node, in dem sich der Startpunkt des Bereichs befindet. startOffset-
Der Versatz in den Anfangsknoten, an dem das erste Zeichen des Bereichs gefunden wird.
endContainer-
Der
Node, in dem sich der Endpunkt des Bereichs befindet. endOffset-
Der Versatz in den Knoten, der durch
endOffsetangegeben ist, an dem sich das letzte Zeichen im Bereich befindet.
Rückgabewert
Ein neues StaticRange-Objekt, das mit den im rangeSpec-Objekt angegebenen Werten initialisiert ist.
Ausnahmen
InvalidNodeTypeError-
Ein
DOMException, der ausgelöst wird, wenn entweder derstartContainerund/oderendContainerein Knotentyp ist, den Sie nicht in einem Bereich einschließen können. Diese Knotentypen sindNode.DOCUMENT_TYPE_NODE(repräsentiert denDocumentType-Knoten, der aus dem DTD abgeleitet ist, das zum Beispiel mithilfe desdoctype-Präambels im HTML identifiziert wird) und derAttr-Knoten, der ein Attribut eines Elements im DOM beschreibt.
Spezifikationen
| Specification |
|---|
| DOM Standard # ref-for-dom-staticrange-staticrange① |
Browser-Kompatibilität
BCD tables only load in the browser