CKTIS / JavaScript
Selection: contare gli intervalli con rangeCount e aggiungerli con addRange()
`rangeCount` indica quanti intervalli contiene la selezione del documento e `addRange()` aggiunge un intervallo del DOM. Per sostituire la selezione con un solo intervallo in modo compatibile tra browser, svuotala prima.
Versione: Current web platform; runtime support varies
Sintassi
// Web platform: Selection API (not part of ECMAScript).
const selection = window.getSelection(); // Selection | null
if (selection !== null) {
const count = selection.rangeCount; // read-only number
selection.addRange(range); // takes a Range; returns undefined
}Selection rappresenta la selezione del documento o la posizione del cursore di testo. Ottieni l’oggetto con window.getSelection() e controlla se il risultato è null. Questa API fa parte della piattaforma web, non di ECMAScript 2024. Per il testo di un textarea o di un tipo di input compatibile, usa invece il metodo setSelectionRange() dell’elemento.
rangeCount è una proprietà numerica di sola lettura. Conta gli oggetti Range, non i caratteri. 0 significa che non c’è alcun intervallo. Puoi avere rangeCount === 1 anche senza testo evidenziato: un intervallo collassato in un solo punto conta comunque. Prima di chiamare getRangeAt(0), controlla che rangeCount > 0, perché un indice fuori dai limiti genera un’eccezione.
addRange(range) accetta un oggetto Range e restituisce undefined, quindi il valore restituito non indica se l’intervallo è stato aggiunto. Crea un intervallo con document.createRange() e impostane i limiti, per esempio con range.selectNodeContents(node) su un nodo collegato allo stesso documento. Un Range è dinamico: le modifiche al DOM possono spostarne i limiti.
La specifica prevede al massimo un intervallo per selezione, ma Firefox ne supporta più di uno. Un browser limitato a un intervallo può ignorare un’altra chiamata a addRange() anziché sostituire l’intervallo esistente. Per impostare in modo affidabile un solo nuovo intervallo, chiama prima removeAllRanges(). In questo modo svuoti la selezione precedente, senza cancellare il contenuto del documento.
Esempi
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Selection API example</title>
</head>
<body>
<script>
(() => {
const selection = window.getSelection();
if (selection === null) throw new Error("No document selection available");
const paragraph = document.createElement("p");
paragraph.textContent = "CKTIS";
document.body.append(paragraph);
try {
const range = document.createRange();
range.selectNodeContents(paragraph);
selection.removeAllRanges();
console.log(selection.rangeCount);
selection.addRange(range);
console.log(selection.rangeCount);
console.log(selection.toString());
} finally {
selection.removeAllRanges();
paragraph.remove();
}
})();
</script>
</body>
</html>Risultato
0 1 CKTIS
Salva l’esempio come file `.html`, aprilo in una scheda separata del browser e controlla la console di sviluppo. Il codice mostra `0` dopo aver svuotato la selezione, poi `1` e `CKTIS` dopo aver aggiunto l’intervallo. Alla fine svuota la selezione e rimuove il paragrafo temporaneo, senza ripristinare la selezione precedente.
Lezioni correlate
- JavaScript · Lezione 33 · Intermedio · Versione: 3