Recherche…
Syntaxe
- Sélection sel = window.getSelection ();
- Sélection sel = document.getSelection (); // équivalent à ce qui précède
- Plage de valeurs = document.createRange ();
- range.setStart (startNode, startOffset);
- range.setEnd (endNode, endOffset);
Paramètres
| Paramètre | Détails |
|---|---|
| startOffset | Si le nœud est un nœud Text, c'est le nombre de caractères entre le début de startNode le début de la plage. Sinon, c'est le nombre de nœuds enfants entre le début de startNode le début de la plage. |
| endOffset | Si le nœud est un nœud Text, il s'agit du nombre de caractères entre le début de startNode et la fin de la plage. Sinon, c'est le nombre de nœuds enfants entre le début de startNode et la fin de la plage. |
Remarques
L'API de sélection vous permet d'afficher et de modifier les éléments et le texte sélectionnés (mis en évidence) dans le document.
Il est implémenté en tant qu'instance singleton Selection qui s'applique au document et contient une collection d'objets Range , chacun représentant une zone sélectionnée contiguë.
En pratique, aucun navigateur, à l'exception de Mozilla Firefox, ne prend en charge plusieurs plages de sélection, ce qui n'est pas non plus encouragé par la spécification. De plus, la plupart des utilisateurs ne sont pas familiers avec le concept de plages multiples. En tant que tel, un développeur ne peut généralement s’occuper que d’une seule plage.
Désélectionnez tout ce qui est sélectionné
let sel = document.getSelection();
sel.removeAllRanges();
Sélectionnez le contenu d'un élément
let sel = document.getSelection();
let myNode = document.getElementById('element-to-select');
let range = document.createRange();
range.selectNodeContents(myNode);
sel.addRange(range);
Il peut être nécessaire de supprimer d'abord toutes les plages de la sélection précédente, car la plupart des navigateurs ne prennent pas en charge plusieurs plages.
Récupère le texte de la sélection
let sel = document.getSelection();
let text = sel.toString();
console.log(text); // logs what the user selected
toString fonction membre toString est appelée automatiquement par certaines fonctions lors de la conversion de l'objet en chaîne, vous ne devez pas toujours l'appeler vous-même.
console.log(document.getSelection());