Document : méthode getSelection()
Baseline
Widely available
Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis novembre 2017.
La méthode getSelection() de l'interface Document retourne l'objet Selection associé à ce document, représentant la plage de texte sélectionnée par l'utilisateur·ice ou la position actuelle du curseur.
Syntaxe
getSelection()
Paramètres
Aucun.
Valeur de retour
Un objet Selection, ou null si le document n'a pas de contexte de navigation (par exemple, s'il s'agit du document d'un <iframe> qui n'est pas attaché à un document).
Exemples
Obtenir un objet Selection
const selection = document.getSelection();
const selRange = selection.getRangeAt(0);
// faire quelque chose avec la plage
console.log(selection); // Objet Selection
Représentation en chaîne de caractères de l'objet Selection
Certaines fonctions (comme Window.alert()) appellent automatiquement toString() et la valeur retournée est passée à la fonction. En conséquence, cela retourne le texte sélectionné et non l'objet Selection :
alert(selection);
Cependant, toutes les fonctions n'appellent pas automatiquement toString().
Pour utiliser un objet Selection comme une chaîne de caractères, appelez directement sa méthode toString() :
let texteSelectionne = selection.toString();
Objets associés
Vous pouvez appeler Window.getSelection(), ce qui est identique à window.document.getSelection().
Il convient de noter qu'actuellement getSelection() ne fonctionne pas sur le contenu des éléments HTML <input> dans Firefox. HTMLInputElement.setSelectionRange() pourrait être utilisé pour contourner ce problème.
On notera également la différence entre selection et focus.
Document.activeElement retourne l'élément qui a une sélection active (le focus en anglais), par exemple un élément de formulaire.
Spécifications
| Specification |
|---|
| Selection API # dom-document-getselection |