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 April 2018.
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
| Specification |
|---|
| DOM # ref-for-dom-range-comparepoint① |
Browser-Kompatibilität
Loading…