Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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

Fonti