Range

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 Range-Schnittstelle repräsentiert ein Fragment eines Dokuments, das Knoten und Teile von Textknoten enthalten kann.

Ein Range kann mit der Methode Document.createRange() erstellt werden. Range-Objekte können auch mit der Methode getRangeAt() des Selection-Objekts oder der Methode caretRangeFromPoint() des Document-Objekts abgerufen werden.

Es steht auch der Range()-Konstruktor zur Verfügung.

AbstractRange Range

Instanz-Eigenschaften

Es gibt keine geerbten Eigenschaften.

Range.collapsed Nur lesbar

Gibt einen booleschen Wert zurück, der angibt, ob die Start- und Endpunkte des Range an derselben Position liegen.

Range.commonAncestorContainer Nur lesbar

Gibt den tiefsten Node zurück, der die startContainer- und endContainer-Knoten enthält.

Range.endContainer Nur lesbar

Gibt den Node zurück, in dem der Range endet.

Range.endOffset Nur lesbar

Gibt eine Zahl zurück, die angibt, wo im endContainer der Range endet.

Range.startContainer Nur lesbar

Gibt den Node zurück, in dem der Range beginnt.

Range.startOffset Nur lesbar

Gibt eine Zahl zurück, die angibt, wo im startContainer der Range beginnt.

Konstruktor

Range()

Gibt ein Range-Objekt mit dem globalen Document als Anfang und Ende zurück.

Instanz-Methoden

Es gibt keine geerbten Methoden.

Range.collapse()

Faltet den Range auf einen seiner Begrenzungspunkte zusammen.

Range.compareBoundaryPoints()

Vergleicht die Begrenzungspunkte des Range mit einem anderen Range.

Range.compareNode() Veraltet Nicht standardisiert

Gibt eine Konstante zurück, die angibt, ob der Node vor, nach, innerhalb oder um den Range herum liegt.

Range.comparePoint()

Gibt -1, 0 oder 1 zurück, um anzuzeigen, ob der Punkt vor, innerhalb oder nach dem Range liegt.

Range.cloneContents()

Gibt ein DocumentFragment zurück, das die Knoten eines Range kopiert.

Range.cloneRange()

Gibt ein Range-Objekt mit Begrenzungspunkten zurück, die mit dem geklonten Range identisch sind.

Range.createContextualFragment()

Gibt ein DocumentFragment zurück, das aus einer gegebenen Zeichenkette von Code erstellt wurde.

Range.deleteContents()

Entfernt den Inhalt eines Range aus dem Document.

Range.detach()

Macht nichts. Beibehalten für Kompatibilität.

Range.extractContents()

Verschiebt Inhalte eines Range aus dem Dokumentbaum in ein DocumentFragment.

Range.getBoundingClientRect()

Gibt ein DOMRect-Objekt zurück, das den gesamten Inhalt des Range umschließt; dies wäre die Vereinigung aller Rechtecke, die von range.getClientRects() zurückgegeben werden.

Range.getClientRects()

Gibt eine Liste von DOMRect-Objekten zurück, die die Ergebnisse von Element.getClientRects() für alle Elemente im Range aggregiert.

Range.isPointInRange()

Gibt einen boolean zurück, der angibt, ob der gegebene Punkt im Range liegt.

Range.insertNode()

Fügt einen Node am Anfang eines Range ein.

Range.intersectsNode()

Gibt einen boolean zurück, der angibt, ob der gegebene Knoten den Range schneidet.

Range.selectNode()

Setzt den Range, um den Node und dessen Inhalt zu enthalten.

Range.selectNodeContents()

Setzt den Range, um den Inhalt eines Node zu enthalten.

Range.setEnd()

Setzt die Endposition eines Range.

Range.setStart()

Setzt die Startposition eines Range.

Range.setEndAfter()

Setzt die Endposition eines Range relativ zu einem anderen Node.

Range.setEndBefore()

Setzt die Endposition eines Range relativ zu einem anderen Node.

Range.setStartAfter()

Setzt die Startposition eines Range relativ zu einem anderen Node.

Range.setStartBefore()

Setzt die Startposition eines Range relativ zu einem anderen Node.

Range.surroundContents()

Verschiebt den Inhalt eines Range in einen neuen Node.

Range.toString()

Gibt den Text des Range zurück.

Spezifikationen

Specification
DOM Standard
# interface-range
DOM Parsing and Serialization
# extensions-to-the-range-interface
CSSOM View Module
# extensions-to-the-range-interface

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch