Range: setEnd() Methode

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⁩.

Die Range.setEnd() Methode setzt die Endposition eines Range an den angegebenen Offset innerhalb des spezifizierten Knotens. Das Setzen des Endpunkts oberhalb (weiter oben im Dokument) als der Startpunkt führt zu einem zusammengeklappten Bereich, bei dem Start- und Endpunkt beide auf die angegebene Endposition gesetzt werden.

Syntax

setEnd(endNode, endOffset)

Parameter

endNode: Der Node innerhalb dessen der Range enden soll.
endOffset: Eine Ganzzahl, die größer oder gleich null ist und den Offset für das Ende des Range vom Anfang von endNode darstellt.

Rückgabewert

Keiner (undefined).

Ausnahmen

InvalidNodeTypeError DOMException: Der durch endNode angegebene Knoten ist ein Doctype-Knoten; Bereichsendpunkte können nicht innerhalb eines Doctype-Knotens festgelegt werden.
IndexSizeError DOMException: Der durch endOffset angegebene Wert ist entweder größer oder gleich der Länge des Knotens oder kleiner als null.

Verwendungshinweise

Wenn der endNode ein Node vom Typ Text, Comment oder CDataSection ist, dann ist endOffset die Anzahl der Zeichen vom Anfang des endNode. Für andere Node Typen ist endOffset die Anzahl der Kindknoten zwischen dem Anfang des endNode.

Beispiele

const range = document.createRange();
const endNode = document.getElementsByTagName("p").item(3);
const endOffset = endNode.childNodes.length;
range.setEnd(endNode, endOffset);

Hinweis:>setEnd() wird häufig in Verbindung mit setStart() verwendet, um einen Bereich vollständig zu konfigurieren.

Spezifikationen

Specification
DOM # dom-range-setend

Browser-Kompatibilität

Siehe auch

Der DOM-Interfaces-Index

Help improve MDN

Learn how to contribute Diese Seite wurde automatisch aus dem Englischen übersetzt.

Übersetzung auf GitHub anzeigen • Fehler mit dieser Übersetzung melden