Range: comparePoint() Methode
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 comparePoint()
Methode der Range
Schnittstelle bestimmt, ob ein spezifizierter Punkt vor, innerhalb oder nach dem Range
liegt. Der Punkt wird durch einen Referenzknoten und einen Offset innerhalb dieses Knotens spezifiziert.
Syntax
comparePoint(referenceNode, offset)
Parameter
referenceNode
-
Der
Node
, zu dem deroffset
relativ ist. offset
-
Eine natürliche Zahl größer oder gleich null, die die Position innerhalb von
referenceNode
des zu überprüfenden Punktes beschreibt. WennreferenceNode
einNode
vom TypText
,Comment
oderCDATASection
ist, dann istoffset
die Anzahl der Zeichen vom Anfang vonreferenceNode
. Für andereNode
Typen istoffset
die Anzahl der Kindknoten vom Anfang desreferenceNode
.
Rückgabewert
Eine Zahl.
-1
, wenn der durch denreferenceNode
undoffset
spezifizierte Punkt vor dem Beginn diesesRange
liegt.0
, wenn der durch denreferenceNode
undoffset
spezifizierte Punkt innerhalb diesesRange
liegt (einschließlich der Start- und Endpunkte des Bereichs).1
, wenn der durch denreferenceNode
undoffset
spezifizierte Punkt nach dem Ende diesesRange
liegt.
Beispiele
const text = new Text("0123456789");
const thisRange = new Range();
thisRange.setStart(text, 1);
thisRange.setEnd(text, 6);
thisRange.comparePoint(text, 3); // 0
thisRange.comparePoint(text, 0); // -1
thisRange.comparePoint(text, 6); // 0
thisRange.comparePoint(text, 7); // 1
Spezifikationen
Specification |
---|
DOM # ref-for-dom-range-comparepoint① |