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 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.collapsedSchreibgeschützt-
Gibt einen booleschen Wert zurück, der angibt, ob die Start- und Endpunkte des
Rangean derselben Position liegen. Range.commonAncestorContainerSchreibgeschützt-
Gibt den tiefsten
Nodezurück, der diestartContainer- undendContainer-Knoten enthält. Range.endContainerSchreibgeschützt-
Gibt den
Nodezurück, in dem derRangeendet. Range.endOffsetSchreibgeschützt-
Gibt eine Zahl zurück, die angibt, wo im
endContainerderRangeendet. Range.startContainerSchreibgeschützt-
Gibt den
Nodezurück, in dem derRangebeginnt. Range.startOffsetSchreibgeschützt-
Gibt eine Zahl zurück, die angibt, wo im
startContainerderRangebeginnt.
Konstruktor
Instanz-Methoden
Es gibt keine geerbten Methoden.
Range.collapse()-
Faltet den
Rangeauf einen seiner Begrenzungspunkte zusammen. Range.compareBoundaryPoints()-
Vergleicht die Begrenzungspunkte des
Rangemit einem anderenRange. Range.compareNode()Veraltet Nicht standardisiert-
Gibt eine Konstante zurück, die angibt, ob der
Nodevor, nach, innerhalb oder um denRangeherum liegt. Range.comparePoint()-
Gibt -1, 0 oder 1 zurück, um anzuzeigen, ob der Punkt vor, innerhalb oder nach dem
Rangeliegt. Range.cloneContents()-
Gibt ein
DocumentFragmentzurück, das die Knoten einesRangekopiert. Range.cloneRange()-
Gibt ein
Range-Objekt mit Begrenzungspunkten zurück, die mit dem geklontenRangeidentisch sind. Range.createContextualFragment()-
Gibt ein
DocumentFragmentzurück, das aus einer gegebenen Zeichenkette von Code erstellt wurde. Range.deleteContents()-
Entfernt den Inhalt eines
Rangeaus demDocument. Range.detach()-
Macht nichts. Beibehalten für Kompatibilität.
Range.extractContents()-
Verschiebt Inhalte eines
Rangeaus dem Dokumentbaum in einDocumentFragment. Range.getBoundingClientRect()-
Gibt ein
DOMRect-Objekt zurück, das den gesamten Inhalt desRangeumschließ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 imRangeaggregiert. Range.isPointInRange()-
Gibt einen
booleanzurück, der angibt, ob der gegebene Punkt imRangeliegt. Range.insertNode()-
Fügt einen
Nodeam Anfang einesRangeein. Range.intersectsNode()-
Gibt einen
booleanzurück, der angibt, ob der gegebene Knoten denRangeschneidet. Range.selectNode()-
Setzt den
Range, um denNodeund dessen Inhalt zu enthalten. Range.selectNodeContents()-
Setzt den
Range, um den Inhalt einesNodezu enthalten. Range.setEnd()-
Setzt die Endposition eines
Range. Range.setStart()-
Setzt die Startposition eines
Range. Range.setEndAfter()-
Setzt die Endposition eines
Rangerelativ zu einem anderenNode. Range.setEndBefore()-
Setzt die Endposition eines
Rangerelativ zu einem anderenNode. Range.setStartAfter()-
Setzt die Startposition eines
Rangerelativ zu einem anderenNode. Range.setStartBefore()-
Setzt die Startposition eines
Rangerelativ zu einem anderenNode. Range.surroundContents()-
Verschiebt den Inhalt eines
Rangein einen neuenNode. Range.toString()-
Gibt den Text des
Rangezurü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
Loading…