CKTIS / JavaScript
Selection — zaznaczenie w dokumencie
Selection reprezentuje zaznaczenie dokumentu. Poznaj rangeCount oraz dodawanie zakresu przez addRange.
Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Składnia
const selection = window.getSelection();
selection.rangeCount;
selection.removeAllRanges();
selection.addRange(range);Selection reprezentuje zaznaczenie dokumentu; Range określa jego granice. Pobierz zaznaczenie przez window.getSelection() i sprawdź, czy wynik to null. To Web API, nie funkcja ECMAScript; Node 24 nie potwierdza obsługi w przeglądarce.
Selection.rangeCount jest tylko do odczytu: według specyfikacji wynosi 0 dla pustego zaznaczenia lub gdy jego granice znajdują się poza drzewem dokumentu, a w pozostałych przypadkach 1. Zwinięty zakres nadal może dawać 1 — nie oznacza to, że zaznaczono tekst.
Po dodaniu zakresu Selection.addRange(range) zachowuje referencję do niego, a nie kopię. Według specyfikacji metoda nic nie robi, jeśli zakres znajduje się poza drzewem dokumentu albo Selection.rangeCount ma wartość inną niż 0. Firefox pozwala jednak dodać kilka zakresów, więc Selection.rangeCount może tam przekroczyć 1. Nie polegaj na obsłudze wielu zakresów w różnych przeglądarkach. Aby zastąpić zaznaczenie, wywołaj removeAllRanges() przed dodaniem nowego zakresu.
Przykłady
(() => {
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();
}
})();Wynik
1: Selection 1: true
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.