Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

Selection — sélection du document

Selection représente la sélection du document. Découvrez rangeCount et comment ajouter une plage avec addRange.

Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntaxe

const selection = window.getSelection();
selection.rangeCount;
selection.removeAllRanges();
selection.addRange(range);

Selection représente la sélection du document ; Range en définit les limites. Récupérez-la avec window.getSelection() et vérifiez si le résultat est null. Il s’agit d’une API Web, et non d’une fonctionnalité ECMAScript ; Node 24 ne permet pas d’établir la prise en charge par les navigateurs.

Selection.rangeCount est en lecture seule : selon la spécification, sa valeur est 0 si la sélection est vide ou si ses limites se trouvent en dehors de l’arbre du document, et 1 dans les autres cas. Une plage réduite à un point peut tout de même donner 1 : cela ne signifie pas que du texte est sélectionné.

Lorsque Selection.addRange(range) ajoute une plage, la méthode en conserve une référence, et non une copie. Selon la spécification, elle ne fait rien si la plage se trouve en dehors de l’arbre du document ou si Selection.rangeCount est différent de 0. Firefox permet toutefois d’ajouter plusieurs plages : Selection.rangeCount peut donc y dépasser 1. Ne comptez pas sur la prise en charge de plusieurs plages dans tous les navigateurs. Pour remplacer la sélection, appelez removeAllRanges() avant d’ajouter la nouvelle plage.

Exemples

(() => {
  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();
  }
})();

Résultat

1: Selection
1: true

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources