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.
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.
Instanz-Eigenschaften
Es gibt keine geerbten Eigenschaften.
Range.collapsed
Nur lesbar-
Gibt einen booleschen Wert zurück, der angibt, ob die Start- und Endpunkte des
Range
an derselben Position liegen. Range.commonAncestorContainer
Nur lesbar-
Gibt den tiefsten
Node
zurück, der diestartContainer
- undendContainer
-Knoten enthält. Range.endContainer
Nur lesbar-
Gibt den
Node
zurück, in dem derRange
endet. Range.endOffset
Nur lesbar-
Gibt eine Zahl zurück, die angibt, wo im
endContainer
derRange
endet. Range.startContainer
Nur lesbar-
Gibt den
Node
zurück, in dem derRange
beginnt. Range.startOffset
Nur lesbar-
Gibt eine Zahl zurück, die angibt, wo im
startContainer
derRange
beginnt.
Konstruktor
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 anderenRange
. Range.compareNode()
Veraltet Nicht standardisiert-
Gibt eine Konstante zurück, die angibt, ob der
Node
vor, nach, innerhalb oder um denRange
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 einesRange
kopiert. Range.cloneRange()
-
Gibt ein
Range
-Objekt mit Begrenzungspunkten zurück, die mit dem geklontenRange
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 demDocument
. Range.detach()
-
Macht nichts. Beibehalten für Kompatibilität.
Range.extractContents()
-
Verschiebt Inhalte eines
Range
aus dem Dokumentbaum in einDocumentFragment
. Range.getBoundingClientRect()
-
Gibt ein
DOMRect
-Objekt zurück, das den gesamten Inhalt desRange
umschließt; dies wäre die Vereinigung aller Rechtecke, die vonrange.getClientRects()
zurückgegeben werden. Range.getClientRects()
-
Gibt eine Liste von
DOMRect
-Objekten zurück, die die Ergebnisse vonElement.getClientRects()
für alle Elemente imRange
aggregiert. Range.isPointInRange()
-
Gibt einen
boolean
zurück, der angibt, ob der gegebene Punkt imRange
liegt. Range.insertNode()
-
Fügt einen
Node
am Anfang einesRange
ein. Range.intersectsNode()
-
Gibt einen
boolean
zurück, der angibt, ob der gegebene Knoten denRange
schneidet. Range.selectNode()
-
Setzt den
Range
, um denNode
und dessen Inhalt zu enthalten. Range.selectNodeContents()
-
Setzt den
Range
, um den Inhalt einesNode
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 anderenNode
. Range.setEndBefore()
-
Setzt die Endposition eines
Range
relativ zu einem anderenNode
. Range.setStartAfter()
-
Setzt die Startposition eines
Range
relativ zu einem anderenNode
. Range.setStartBefore()
-
Setzt die Startposition eines
Range
relativ zu einem anderenNode
. Range.surroundContents()
-
Verschiebt den Inhalt eines
Range
in einen neuenNode
. Range.toString()
-
Gibt den Text des
Range
zurück.
Spezifikationen
Specification |
---|
DOM Standard # interface-range |
DOM Parsing and Serialization # extensions-to-the-range-interface |
CSSOM View Module # extensions-to-the-range-interface |
Browser-Kompatibilität
BCD tables only load in the browser