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.

* 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 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 Schreibgeschützt

Gibt einen booleschen Wert zurück, der angibt, ob die Start- und Endpunkte des Range 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 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
# interface-range
DOM Parsing and Serialization
# extensions-to-the-range-interface
CSSOM View Module
# extensions-to-the-range-interface

Browser-Kompatibilität

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Range
Range() constructor
cloneContents
cloneRange
collapse
toStart parameter is optional
collapsed
commonAncestorContainer
compareBoundaryPoints
compareNode
DeprecatedNon-standard
comparePoint
createContextualFragment
deleteContents
detach
endContainer
endOffset
extractContents
getBoundingClientRect
getClientRects
insertNode
intersectsNode
isPointInRange
selectNode
selectNodeContents
setEnd
setEndAfter
setEndBefore
setStart
setStartAfter
setStartBefore
startContainer
startOffset
surroundContents
toString

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support
Non-standard. Check cross-browser support before using.
Deprecated. Not for use in new websites.
See implementation notes.

Siehe auch