Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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.

Fonti