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 Range.collapse()-Methode kollabiert den Range zu einem seiner Randpunkte.

Ein kollabierter Range ist leer und enthält keinen Inhalt, wobei er einen einzelnen Punkt in einem DOM-Baum angibt. Um festzustellen, ob ein Range bereits kollabiert ist, sehen Sie sich die Range.collapsed Eigenschaft an.

Syntax

js
collapse()
collapse(toStart)

Parameter

toStart Optional

Ein boolescher Wert: true kollabiert den Range zu seinem Anfang, false zu seinem Ende. Wenn dieser Parameter weggelassen wird, ist er standardmäßig 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 Standard
# dom-range-collapse

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch