CKTIS / JavaScript
Selection — selezione del documento
Selection rappresenta la selezione del documento. Scopri rangeCount e come aggiungere un intervallo con addRange.
Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintassi
const selection = window.getSelection();
selection.rangeCount;
selection.removeAllRanges();
selection.addRange(range);Selection rappresenta la selezione del documento; Range ne definisce i confini. Recuperala tramite window.getSelection() e controlla se il risultato è null. È una Web API, non una funzionalità ECMAScript; Node 24 non dimostra il supporto nei browser.
Selection.rangeCount è di sola lettura: secondo la specifica vale 0 se la selezione è vuota o i suoi confini sono fuori dall’albero del documento, altrimenti 1. Anche un intervallo collassato può far sì che il valore sia 1: questo non significa che sia selezionato del testo.
Quando Selection.addRange(range) aggiunge un intervallo, mantiene un riferimento, non una copia. Secondo la specifica, il metodo non fa nulla se l’intervallo è fuori dall’albero del documento o se Selection.rangeCount è diverso da 0. Firefox, però, consente di aggiungere più intervalli, quindi in quel browser Selection.rangeCount può superare 1. Non dare per scontato che tutti i browser supportino più intervalli. Per sostituire la selezione, chiama removeAllRanges() prima di aggiungere il nuovo intervallo.
Esempi
(() => {
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();
}
})();Risultato
1: Selection 1: true
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.