Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.

View in English Always switch to English

Document : évènement selectionchange

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 mars 2017.

L'évènement selectionchange de l'API de sélection est déclenché lorsque la Selection actuelle d'un Document est modifiée.

Cet évènement n'est pas annulable et ne se propage pas.

L'évènement peut être géré en ajoutant un écouteur d'évènement pour selectionchange ou en utilisant le gestionnaire d'évènement onselectionchange.

Note : Cet évènement n'est pas tout à fait le même que les évènements selectionchange déclenchés lorsque la sélection de texte dans un élément HTML <input> ou <textarea> est modifiée. Voir l'évènement selectionchange de HTMLInputElement pour plus de détails.

Syntaxe

Utilisez le nom de l'évènement dans des méthodes comme addEventListener(), ou définissez une propriété de gestionnaire d'évènement.

js
addEventListener("selectionchange", (event) => { })

onselectionchange = (event) => { }

Type d'évènement

Un objet Event générique.

Exemples

js
// Version avec addEventListener
document.addEventListener("selectionchange", () => {
  console.log(document.getSelection());
});

// Version avec onselectionchange
document.onselectionchange = () => {
  console.log(document.getSelection());
};

Spécifications

Specification
Selection API
# selectionchange-event
Selection API
# dom-globaleventhandlers-onselectionchange

Compatibilité des navigateurs

Voir aussi