Selection API

L’API Selection fournit des fonctionnalités pour lire et manipuler les plages (en anglais : ranges) de texte sélectionnées par l’utilisatrice ou l’utilisateur.

Concepts et utilisation

Pour obtenir la plage de texte actuellement sélectionnée par l’utilisatrice ou l’utilisateur, vous pouvez utiliser la méthode Window.getSelection() ou Document.getSelection(), et stocker la valeur de retour – un objet Selection – dans une variable pour une utilisation ultérieure.

Une fois que votre sélection est dans une variable, vous pouvez effectuer différentes opérations dessus, par exemple :

Vous pouvez exécuter du code en réponse à un changement de sélection, ou au commencement d’une nouvelle sélection, en utilisant les gestionnaires d’évènements GlobalEventHandlers.onselectionchange et GlobalEventHandlers.onselectstart.

Interfaces de l’API Selection

Selection
Représente la plage de texte sélectionnée ou la position actuelle du curseur.

Extensions à d’autres interfaces

Window.getSelection(), Document.getSelection()
Retourne un objet Selection représentant la plage de texte sélectionnée ou la position actuelle du curseur. Document.getSelection() est en quelques sortes un alias de Window.getSelection().
GlobalEventHandlers.onselectstart
Représente le gestionnaire d’évènement qui est appelé quand un évènement selectstart est émis sur l’objet concerné (c’est-à-dire quand une nouvelle plage de texte est sur le point d’être sélectionnée).
GlobalEventHandlers.onselectionchange
Représente le gestionnaire d’évènement qui est appelé quand un évènement selectionchange est émis sur l’objet concerné (c’est-à-dire quand la plage de texte sélectionné change).

Spécifications

Spécification Statut Commentaire
Selection API
La définition de 'Selection' dans cette spécification.
Version de travail La spécification de l’API Selection est basée sur la spécification de l’API Édition HTML et se concentre sur les fonctionnalités liées à la sélection.
HTML Editing APIs
La définition de 'Selection' dans cette spécification.
Brouillon de l'éditeur Définition initiale (plus ancienne), à présent obsolète.

Compatibilité des navigateurs

Nous convertissons les données de compatibilité dans un format JSON. Ce tableau de compatibilité utilise encore l'ancien format car nous n'avons pas encore converti les données qu'il contient. Vous pouvez nous aider en contribuant !

Fonctionnalité Chrome Edge Firefox (Gecko) Internet Explorer Opera Safari (WebKit)
Support de base (Oui) (Oui) (Oui)
52 (52)[1]
9 (Oui) (Oui)
modify() (Oui) ? 4.0 (2) ? ? (Oui)
setBaseAndExtent() ? ? 53 (53) ? ? ?
deleteFromDocument() ? (Oui) 55 (55) ? ? ?
empty() comme alias de removeAllRanges() (Oui) ? 55 (55) ? (Oui) (Oui)
setPosition() comme alias de collapse() (Oui) ? 55 (55) ? (Oui) (Oui)
Fonctionnalité Android Edge Firefox Mobile (Gecko) IE Phone Opera Mobile Safari Mobile
Support de base ? (Oui)

(Oui)
52.0 (52)[1]

? ? (Oui)
modify() ? ? 4.0 (2) ? ? (Oui)
setBaseAndExtent() ? ? 53.0 (53) ? ? ?
deleteFromDocument() ? (Oui) 55.0 (55) ? ? ?
empty() comme alias de removeAllRanges() ? ? 55.0 (55) ? (Oui) (Oui)
setPosition() comme alias de collapse() ? ? 55.0 (55) ? (Oui) (Oui)

[1] Les gestionnaires d’évènements GlobalEventHandlers.onselectionchange et GlobalEventHandlers.onselectstart sont supportés à partir de Firefox 52.

Voir aussi

Étiquettes et contributeurs liés au document

Contributeurs à cette page : Watilin
Dernière mise à jour par : Watilin,