Range: comparePoint() Methode
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit April 2018 browserübergreifend verfügbar.
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 deroffsetrelativ ist. offset-
Eine natürliche Zahl größer oder gleich null, die die Position innerhalb von
referenceNodedes zu überprüfenden Punktes beschreibt. WennreferenceNodeeinNodevom TypText,CommentoderCDATASectionist, dann istoffsetdie Anzahl der Zeichen vom Anfang vonreferenceNode. Für andereNodeTypen istoffsetdie Anzahl der Kindknoten vom Anfang desreferenceNode.
Rückgabewert
Eine Zahl.
-1, wenn der durch denreferenceNodeundoffsetspezifizierte Punkt vor dem Beginn diesesRangeliegt.0, wenn der durch denreferenceNodeundoffsetspezifizierte Punkt innerhalb diesesRangeliegt (einschließlich der Start- und Endpunkte des Bereichs).1, wenn der durch denreferenceNodeundoffsetspezifizierte Punkt nach dem Ende diesesRangeliegt.
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
| Spezifikation |
|---|
| DOM # ref-for-dom-range-comparepoint① |