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