Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

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.

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

Ein Bereich kann mithilfe der Methode Document.createRange() erstellt werden. Range-Objekte können auch durch die Verwendung 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

Die unten aufgeführten Eigenschaften sind von ihrem Eltern-Interface AbstractRange geerbt.

Range.collapsed Schreibgeschützt

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

Range.commonAncestorContainer Schreibgeschützt

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

Range.endContainer Schreibgeschützt

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

Range.endOffset Schreibgeschützt

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

Range.startContainer Schreibgeschützt

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

Range.startOffset Schreibgeschützt

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

Konstruktor

Range()

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

Instanzmethoden

Es gibt keine geerbten Methoden.

Range.collapse()

Reduziert den Range auf einen seiner Begrenzungspunkte.

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 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 Begrenzungspunkten zum geklonten Range zurück.

Range.createContextualFragment()

Gibt ein DocumentFragment zurück, das aus einem gegebenen Code-String erstellt wurde.

Range.deleteContents()

Entfernt die Inhalte eines Range aus dem Document.

Range.detach()

Macht nichts. Wird aus Kompatibilitätsgründen beibehalten.

Range.extractContents()

Verschiebt Inhalte eines Range vom 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 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
# interface-range
DOM Parsing and Serialization
# extensions-to-the-range-interface
CSSOM View Module
# extensions-to-the-range-interface

Browser-Kompatibilität

Siehe auch