Range: Methode setEnd()
Die Range.setEnd()
-Methode setzt die Endposition eines Range
auf die angegebene Verschiebung in den spezifizierten Knoten. Wenn der Endpunkt höher (weiter oben im Dokument) als der Startpunkt gesetzt wird, führt dies zu einem zusammengeklappten Bereich, bei dem die Start- und Endpunkte beide auf die angegebene Endposition gesetzt werden.
Syntax
setEnd(endNode, endOffset)
Parameter
Rückgabewert
Keiner (undefined
).
Ausnahmen
InvalidNodeTypeError
DOMException
-
Der durch
endNode
angegebene Knoten ist ein Doctype-Knoten; Bereichs-Endpunkte können nicht innerhalb eines Doctype-Knotens liegen. IndexSizeError
DOMException
-
Der durch
endOffset
angegebene Wert ist entweder größer als oder gleich der Länge des Knotens oder kleiner als null.
Gebrauchshinweise
Wenn das endNode
ein Node
des Typs Text
,
Comment
oder CDataSection
ist, dann ist endOffset
die Anzahl der Zeichen vom Start von endNode
. Für andere
Node
-Typen ist endOffset
die Anzahl der Kindknoten zwischen
dem Start des endNode
.
Beispiele
const range = document.createRange();
const endNode = document.getElementsByTagName("p").item(3);
const endOffset = endNode.childNodes.length;
range.setEnd(endNode, endOffset);
Note:
setEnd()
wird häufig in Verbindung mitsetStart()
verwendet, um einen Bereich vollständig zu konfigurieren.
Spezifikationen
Specification |
---|
DOM Standard # dom-range-setend |
Browser-Kompatibilität
BCD tables only load in the browser