Range: collapse() Methode

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 collapse() Methode des Range Schnittstelle reduziert den Range auf einen seiner Grenzpunkte.

Ein kollabierter Range ist leer und enthält keinen Inhalt, sondern gibt einen Einzelpunkt in einem DOM-Baum an. Um festzustellen, ob ein Range bereits kollabiert ist, siehe die Range.collapsed Eigenschaft.

Syntax

js
collapse()
collapse(toStart)

Parameter

toStart Optional

Ein boolescher Wert: true kollabiert den Range zu seinem Anfang, false zu seinem Ende. Wenn weggelassen, ist der Standardwert false.

Rückgabewert

Keiner (undefined).

Beispiele

js
const range = document.createRange();

const referenceNode = document.getElementsByTagName("div").item(0);
range.selectNode(referenceNode);
range.collapse(true);

Spezifikationen

Specification
DOM
# dom-range-collapse

Browser-Kompatibilität

Siehe auch