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

Ein Bereich kann mit der MethodeDocument.createRange() erstellt werden. Bereichsobjekte können auch mit der MethodegetRangeAt() desSelection-Objekts oder der MethodecaretRangeFromPoint() desDocument-Objekts abgerufen werden.

Es gibt auch denRange()-Konstruktor.

Konstruktor

Range()

Gibt einRange-Objekt mit dem globalenDocument als Anfang und Ende zurück.

Instanz-Eigenschaften

Erbt auch Eigenschaften von seiner Elternschnittstelle,AbstractRange.

Range.commonAncestorContainerSchreibgeschützt

Gibt den tiefstenNode zurück, der diestartContainer- undendContainer-Knoten enthält.

Instanz-Methoden

Es gibt keine geerbten Methoden.

Range.collapse()

Reduziert dasRange auf einen seiner Grenzpunkte.

Range.compareBoundaryPoints()

Vergleicht die Grenzpunkte desRange mit einem anderenRange.

Range.compareNode()VeraltetNicht standardisiert

Gibt eine Konstante zurück, die darstellt, ob derNode 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 demRange auftritt.

Range.cloneContents()

Gibt einDocumentFragment zurück, das die Knoten einesRange kopiert.

Range.cloneRange()

Gibt einRange-Objekt mit identischen Grenzpunkten wie das geklonteRange zurück.

Range.createContextualFragment()

Gibt einDocumentFragment zurück, das aus einem gegebenen String mit Code erstellt wurde.

Range.deleteContents()

Entfernt den Inhalt einesRange aus demDocument.

Range.detach()Veraltet

Macht nichts. Wird zur Kompatibilität beibehalten.

Range.extractContents()

Bewegt den Inhalt einesRange aus dem Dokumentbaum in einDocumentFragment.

Range.getBoundingClientRect()

Gibt einDOMRect-Objekt zurück, das den gesamten Inhalt desRange umschließt; dies wäre die Vereinigung aller vonrange.getClientRects() zurückgegebenen Rechtecke.

Range.getClientRects()

Gibt eine Liste vonDOMRect-Objekten zurück, die die Ergebnisse vonElement.getClientRects() für alle Elemente imRange aggregiert.

Range.isPointInRange()

Gibt einenboolean zurück, der anzeigt, ob der gegebene Punkt imRange liegt.

Range.insertNode()

Fügt einenNode am Anfang einesRange ein.

Range.intersectsNode()

Gibt einenboolean zurück, der anzeigt, ob der gegebene Knoten denRange schneidet.

Range.selectNode()

Setzt dasRange, um denNode und dessen Inhalte einzuschließen.

Range.selectNodeContents()

Setzt dasRange, um die Inhalte einesNode einzuschließen.

Range.setEnd()

Setzt die Endposition einesRange.

Range.setStart()

Setzt die Startposition einesRange.

Range.setEndAfter()

Setzt die Endposition einesRange relativ zu einem anderenNode.

Range.setEndBefore()

Setzt die Endposition einesRange relativ zu einem anderenNode.

Range.setStartAfter()

Setzt die Startposition einesRange relativ zu einem anderenNode.

Range.setStartBefore()

Setzt die Startposition einesRange relativ zu einem anderenNode.

Range.surroundContents()

Verschiebt den Inhalt einesRange in einen neuenNode.

Range.toString()

Gibt den Text desRange zurück.

Spezifikationen

Browser-Kompatibilität

Siehe auch

• Das DOM-Schnittstellenverzeichnis