WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Range — ein lebender Bereich im DOM-Baum

Range beschreibt einen DOM-Abschnitt zwischen zwei Grenzen. Damit lassen sich Inhalte ausschneiden, löschen und einfügen; die Grenzen reagieren automatisch auf Änderungen im Baum.

Version: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntax

const range = document.createRange();
range.setStart(node, startOffset);
range.setEnd(node, endOffset);
range.extractContents();
range.insertNode(node);

Range ist ein lebender Bereich, der durch zwei Paare aus Knoten und Offset definiert wird. Er lässt sich mit document.createRange() oder new Range() erstellen. Es handelt sich um eine Web-API des DOM-Standards, nicht um eine Funktion einer bestimmten ECMAScript-Ausgabe; Node 24 in einem Repository belegt nicht, dass die API verfügbar ist. Das Beispiel benötigt ein Browser-DOM.

Range.startOffset und Range.endOffset zählen in CharacterData UTF-16-Codeeinheiten, in Elementen jedoch untergeordnete Knoten und keine Zeichen. Range.commonAncestorContainer liefert den tiefsten gemeinsamen Knoten, der beide Grenzen umfasst; das kann der Textknoten selbst sein. Range.collapsed bedeutet, dass die Grenzen identisch sind, nicht nur, dass der Text leer ist.

Range.extractContents() entfernt Inhalte und gibt ein DocumentFragment zurück: vollständig enthaltene Knoten werden verschoben, teilweise enthaltene Strukturen werden bei Bedarf kopiert. Range.deleteContents() entfernt Inhalte, ohne ein Fragment zurückzugeben. Beide Vorgänge kollabieren den Bereich. Range.insertNode(node) fügt am Anfang ein, statt Inhalte zu ersetzen; dabei kann ein Textknoten geteilt und ein kollabierter Bereich erweitert werden.

Range.setStartAfter(node) setzt den Anfang hinter den Knoten in dessen übergeordnetem Knoten; der Knoten muss einen übergeordneten Knoten haben. Range.collapse(true) kollabiert zum Anfang, Range.collapse(false) oder Range.collapse() zum Ende. Range.cloneRange() erstellt einen eigenen lebenden Bereich mit denselben Grenzen, keine DOM-Kopie und keinen unveränderlichen Schnappschuss: Spätere Änderungen können beide Bereiche beeinflussen.

Beispiele

(() => {
  const host = document.createElement('div');
  host.textContent = 'ABCDE';
  const range = document.createRange();
  range.setStart(host.firstChild, 1);
  range.setEnd(host.firstChild, 4);
  console.log(range.commonAncestorContainer === host.firstChild);
  console.log(range.startOffset, range.endOffset, range.collapsed);

  const copy = range.cloneRange();
  copy.collapse(true);
  console.log(copy.collapsed, range.collapsed);

  const fragment = range.extractContents();
  console.log(fragment.textContent, host.textContent, range.collapsed);
  const mark = document.createElement('mark');
  mark.appendChild(fragment);
  range.insertNode(mark);
  range.setStartAfter(mark);
  range.collapse(true);
  console.log(host.textContent, range.startOffset, range.endOffset);

  range.selectNode(mark);
  range.deleteContents();
  console.log(host.textContent, range.collapsed);
})();

Ergebnis

true
1 4 false
true false
BCD AE true
ABCDE 2 2
AE true

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen