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 Range-Objekt kann mit der Methode Document.createRange() erstellt werden. Range-Objekte können auch durch die Methode getRangeAt() des Selection-Objekts oder die Methode caretRangeFromPoint() des Document-Objekts abgerufen werden.

Es gibt auch den Range()-Konstruktor.

Konstruktor

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

Instanz-Eigenschaften

Erbt auch Eigenschaften von der übergeordneten Schnittstelle, AbstractRange.

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

Instanz-Methoden

Es gibt keine vererbten Methoden.

Range.collapse(): Kollabiert das Range zu einem seiner Grenzpunkte.
Range.compareBoundaryPoints(): Vergleicht die Grenzpunkte 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 das 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 identischen Grenzpunkten wie das geklonte Range zurück.
Range.createContextualFragment(): Gibt ein DocumentFragment zurück, das aus einem angegebenen Code-String erstellt wurde.
Range.deleteContents(): Entfernt die Inhalte eines Range aus dem Document.
Range.detach(): Tut nichts. Beibehalten für Kompatibilität.
Range.extractContents(): Verschiebt die Inhalte eines Range aus dem Dokumentbaum in ein DocumentFragment.
Range.getBoundingClientRect(): Gibt ein DOMRect-Objekt zurück, das die gesamten Inhalte des Range umfasst; 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 zusammenfasst.
Range.isPointInRange(): Gibt ein boolean zurück, das angibt, ob der angegebene Punkt im Range liegt.
Range.insertNode(): Fügt einen Node am Anfang eines Range ein.
Range.intersectsNode(): Gibt ein boolean zurück, das angibt, ob der angegebene Knoten das Range schneidet.
Range.selectNode(): Legt das Range fest, um den Node und seine Inhalte zu enthalten.
Range.selectNodeContents(): Legt das Range fest, um die Inhalte eines Node zu enthalten.
Range.setEnd(): Legt die Endposition eines Range fest.
Range.setStart(): Legt die Startposition eines Range fest.
Range.setEndAfter(): Legt die Endposition eines Range relativ zu einem anderen Node fest.
Range.setEndBefore(): Legt die Endposition eines Range relativ zu einem anderen Node fest.
Range.setStartAfter(): Legt die Startposition eines Range relativ zu einem anderen Node fest.
Range.setStartBefore(): Legt die Startposition eines Range relativ zu einem anderen Node fest.
Range.surroundContents(): Verschiebt Inhalte 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

Der DOM-Schnittstellenindex

Help improve MDN

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

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