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

HTMLElement : évènement change

Baseline
Large disponibilité

Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis juillet 2015.

L'évènement change de l'interface HTMLElement est déclenché sur les éléments HTML <input>, <select> et <textarea> lorsque la personne modifie la valeur de l'élément. À la différence de l'évènement input, l'évènement change n'est pas nécessairement déclenché à chaque modification unitaire de la valeur de l'élément.

Selon le type d'élément modifié et l'interaction avec l'élément, l'évènement change pourra se déclencher à un moment différent :

  • Quand un élément <input type="checkbox"> est coché ou décoché (au clic ou au clavier) ;
  • Quand un élément <input type="radio"> est sélectionné (mais pas lorsqu'il est désélectionné) ;
  • Lorsque l'utilisateur·ice applique le changement explicitement (par exemple en sélectionnant une valeur dans une liste déroulante <select> à l'aide du clic de la souris, en sélectionnant une date dans un sélecteur <input type="date">, ou en sélectionnant un fichier dans le sélecteur de fichiers <input type="file">, etc.) ;
  • Lorsque l'élément perd le focus après que la valeur a été changée pour les éléments où il s'agit de saisir une valeur plutôt que d'en sélectionner une, comme <textarea> ou les champs de type text, search, url, tel, email, ou password de l'élément HTML <input>.

La spécification HTML liste les types d'éléments <input> qui devraient déclencher l'évènement change.

Syntaxe

On utilisera le nom de l'évènement dans des méthodes telles que addEventListener(), ou alors on utilisera une propriété globale de gestion d'évènements telle que onchange.

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

onchange = (event) => { }

Type d'évènement

Un évènement générique de type Event.

Exemples

Avec un élément