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

js
comparePoint(referenceNode, offset)

Parameter

referenceNode

Der Node, zu dem der offset relativ ist.

offset

Eine natürliche Zahl größer oder gleich null, die die Position innerhalb von referenceNode des zu überprüfenden Punktes beschreibt. Wenn referenceNode ein Node vom Typ Text, Comment oder CDATASection ist, dann ist offset die Anzahl der Zeichen vom Anfang von referenceNode. Für andere Node Typen ist offset die Anzahl der Kindknoten vom Anfang des referenceNode.

Rückgabewert

Eine Zahl.

  • -1, wenn der durch den referenceNode und offset spezifizierte Punkt vor dem Beginn dieses Range liegt.
  • 0, wenn der durch den referenceNode und offset spezifizierte Punkt innerhalb dieses Range liegt (einschließlich der Start- und Endpunkte des Bereichs).
  • 1, wenn der durch den referenceNode und offset spezifizierte Punkt nach dem Ende dieses Range liegt.

Beispiele

js
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

Siehe auch