API Selection
Note :
Cette API n'est pas disponible dans les web workers (elle n'est pas exposée via WorkerNavigator
).
L'API Selection permet d'accéder et de manipuler les portions du document sélectionnées par l'utilisatrice ou l'utilisateur.
Les méthodes Window.getSelection()
et Document.getSelection()
renvoient un objet Selection
qui représente la portion du document sélectionnée par la personne. Un objet Selection
fournit des méthodes pour :
- accéder aux nœuds actuellement sélectionnés
- modifier la sélection courante en l'étendant ou en la réduisant, voire en sélectionnant une toute autre partie du document
- supprimer des parties de la sélection courante du DOM.
L'API Selection fournit deux évènements, qui se déclenchent sur Document
:
- l'évènement
selectstart
qui est déclenché lorsque l'utilisatrice ou l'utilisateur démarre une nouvelle sélection - l'évènement
selectionchange
qui est déclenché lorsque la sélection courante change.
Interfaces
Selection
-
Une interface qui représente la partie du document sélectionnée par l'utilisatrice ou l'utilisateur, ou la position courante du curseur.
Document.getSelection()
-
Une méthode renvoyant un objet
Selection
qui représente la sélection courante ou la position courante du curseur. Window.getSelection()
-
Une méthode renvoyant un objet
Selection
qui représente la sélection courante ou la position courante du curseur. selectionchange
-
Un évènement déclenché lorsque la sélection courante change.
selectstart
-
Un évènement déclenché lorsqu'une nouvelle sélection est initiée.
Spécifications
Specification |
---|
Selection API # selection-interface |