CKTIS / JavaScript
Selection — Dokumentauswahl
Selection steht für die Auswahl im Dokument. Erfahre mehr über rangeCount und darüber, wie du mit addRange einen Bereich hinzufügst.
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 selection = window.getSelection();
selection.rangeCount;
selection.removeAllRanges();
selection.addRange(range);Selection steht für die Auswahl im Dokument; Range legt ihre Grenzen fest. Rufe sie über window.getSelection() ab und prüfe, ob das Ergebnis null ist. Dies ist eine Web API, keine ECMAScript-Funktion; Node 24 belegt keine Browserunterstützung.
Selection.rangeCount ist schreibgeschützt: Laut Spezifikation ist der Wert 0, wenn die Auswahl leer ist oder ihre Grenzen außerhalb des Dokumentbaums liegen, andernfalls 1. Auch ein eingeklappter Bereich kann den Wert 1 ergeben — das bedeutet nicht, dass Text ausgewählt ist.
Wenn Selection.addRange(range) einen Bereich hinzufügt, speichert die Methode eine Referenz und keine Kopie. Laut Spezifikation tut die Methode nichts, wenn der Bereich außerhalb des Dokumentbaums liegt oder Selection.rangeCount ungleich 0 ist. In Firefox lassen sich jedoch mehrere Bereiche hinzufügen, sodass Selection.rangeCount dort größer als 1 sein kann. Verlasse dich nicht darauf, dass mehrere Bereiche browserübergreifend unterstützt werden. Um die Auswahl zu ersetzen, rufe removeAllRanges() auf, bevor du den neuen Bereich hinzufügst.
Beispiele
(() => {
const selection = window.getSelection();
if (!selection || !document.body) {
throw new Error('An active browser document with a body is required.');
}
const paragraph = document.createElement('p');
paragraph.textContent = 'Hello Selection';
document.body.append(paragraph);
const range = document.createRange();
range.setStart(paragraph.firstChild, 6);
range.setEnd(paragraph.firstChild, 15);
try {
selection.removeAllRanges();
selection.addRange(range);
console.log(selection.rangeCount + ': ' + selection.toString());
range.collapse(true);
console.log(selection.rangeCount + ': ' + selection.isCollapsed);
} finally {
selection.removeAllRanges();
paragraph.remove();
}
})();Ergebnis
1: Selection 1: 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.