Range

Baseline Widely available *

This feature is well established and works across many devices and browser versions. It’s been available across browsers since Juli 2015.

* Some parts of this feature may have varying levels of support.

Die Range-Schnittstelle repräsentiert ein Fragment eines Dokuments, das Knoten und Teile von Textknoten enthalten kann.

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

Es gibt auch den Range()-Konstruktor.

Konstruktor

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

Instanz-Eigenschaften

Erbt auch Eigenschaften von seiner Elternschnittstelle, AbstractRange.

Range.commonAncestorContainer Schreibgeschützt: Gibt den tiefsten Node zurück, der die startContainer- und endContainer-Knoten enthält.

Instanz-Methoden

Es gibt keine geerbten Methoden.

Range.collapse(): Reduziert das Range auf einen seiner Grenzpunkte.
Range.compareBoundaryPoints(): Vergleicht die Grenzpunkte des Range mit einem anderen Range.
Range.compareNode() Veraltet Nicht standardisiert: Gibt eine Konstante zurück, die darstellt, ob der Node vor, nach, innerhalb oder um den Bereich herum liegt.
Range.comparePoint(): Gibt -1, 0 oder 1 zurück, um anzuzeigen, ob der Punkt vor, innerhalb oder nach dem Range auftritt.
Range.cloneContents(): Gibt ein DocumentFragment zurück, das die Knoten eines Range kopiert.
Range.cloneRange(): Gibt ein Range-Objekt mit identischen Grenzpunkten wie das geklonte Range zurück.
Range.createContextualFragment(): Gibt ein DocumentFragment zurück, das aus einem gegebenen String mit Code erstellt wurde.
Range.deleteContents(): Entfernt den Inhalt eines Range aus dem Document.
Range.detach() Veraltet: Macht nichts. Wird zur Kompatibilität beibehalten.
Range.extractContents(): Bewegt den Inhalt 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 von range.getClientRects() zurückgegebenen Rechtecke.
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 anzeigt, 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 anzeigt, ob der gegebene Knoten den Range schneidet.
Range.selectNode(): Setzt das Range, um den Node und dessen Inhalte einzuschließen.
Range.selectNodeContents(): Setzt das Range, um die Inhalte eines Node einzuschließen.
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 # interface-range
DOM Parsing and Serialization # extensions-to-the-range-interface
CSSOM View Module # extensions-to-the-range-interface

Browser-Kompatibilität

Siehe auch

Das DOM-Schnittstellenverzeichnis

Help improve MDN

Learn how to contribute Diese Seite wurde automatisch aus dem Englischen übersetzt.

Übersetzung auf GitHub anzeigen • Fehler mit dieser Übersetzung melden