Attribut global HTMLAttributs globaux

onchange

Exécute du code JavaScript lorsque l’utilisateur valide une nouvelle valeur du champ : choisit une option, coche une case ou termine sa saisie.

S’applique à
<input>, <select> et <textarea>. L’événement remonte, donc l’attribut fonctionne aussi sur <form>
Sur cette page

Exemple

#
HTML
<label for="course">Choisissez une formation</label>
<select id="course" onchange="
  const course = this.selectedOptions[0].text;
  document.getElementById('choice').textContent = 'Formation choisie : ' + course;
">
  <option value="">Aucun choix</option>
  <option value="html">HTML et CSS</option>
  <option value="js">JavaScript</option>
  <option value="python">Python</option>
</select>
<p id="choice">Formation choisie : aucune</p>

<label>
  <input type="checkbox" onchange="document.body.style.fontSize = this.checked ? '18px' : ''">
  Police plus grande dans l’aperçu
</label>
Aperçu

La liste réagit dès le choix d’une option, et la case à cocher à chaque cochage et décochage. L’état du champ est lu avec this.checked.

Définition et utilisation

#

L’attribut onchange réagit à l’événement change, qui se produit lorsque l’utilisateur valide une nouvelle valeur du champ. Dans les listes <select>, les cases à cocher, les boutons radio et les champs de fichier, cela se produit juste après le choix. Dans les champs de texte, seulement lorsque l’utilisateur quitte le champ ou appuie sur Entrée, et que la valeur diffère de celle d’avant la modification. Dans un <textarea>, Entrée ajoute un saut de ligne, donc seule la sortie du champ compte.

C’est pourquoi onchange convient aux réglages et aux filtres : changement de tri, interrupteur du mode sombre, choix d’un fichier à envoyer. Pour réagir à chaque caractère saisi, oninput est préférable. Avec un curseur range, l’événement change ne se produit qu’une fois la poignée relâchée, et input tout au long du déplacement.

Dans le code de l’attribut, this désigne le champ. Vous lisez la valeur avec this.value, l’état d’une case à cocher avec this.checked et les fichiers choisis avec this.files. Comme input, l’événement change remonte dans l’arbre et ne se produit pas lorsqu’un script modifie la valeur. Dans des projets plus importants, ajoutez la gestion avec addEventListener("change", …).

Syntaxe

#
Syntaxe
<select onchange="code JavaScript">…</select>

Disponible dans le code de l’attribut

#
  • this.value

    La valeur du champ ou l’attribut value de l’option choisie dans la liste.
  • this.checked

    true ou false dans les cases à cocher et les boutons radio.
  • this.selectedOptions

    Les options choisies d’une liste <select>. Vous lisez le texte de la première avec this.selectedOptions[0].text.
  • this.files

    Les fichiers choisis dans <input type="file">, chacun avec un nom, une taille et un type.

Plus d’exemples

#
Comparaison des événements input et change
HTML
<label for="city">Ville</label>
<input id="city" type="text"
  oninput="document.getElementById('input-log').textContent = this.value"
  onchange="document.getElementById('change-log').textContent = this.value">
<p>input : <strong id="input-log"></strong></p>
<p>change : <strong id="change-log"></strong></p>
Aperçu

Saisissez le nom d’une ville. La ligne « input » change à chaque caractère, et « change » seulement lorsque vous appuyez sur Entrée ou cliquez en dehors du champ.

Compatibilité des navigateurs

#

Largement disponible

Fonctionne dans tous les navigateurs modernes, y compris sur mobile. Vous pouvez l’utiliser sans crainte.

  • Chrome
  • Edge
  • Firefox
  • Safari

Bonnes pratiques

#
  • N’envoyez pas l’utilisateur vers une autre page dès le choix d’une option dans une liste. Quelqu’un qui parcourt la liste avec les flèches du clavier peut déclencher change à chaque option. Ajoutez un bouton « Aller ».
  • Dans un champ de fichier, vérifiez dans onchange la taille et le type du fichier avant de l’envoyer. C’est un confort pour l’utilisateur, mais le serveur doit de toute façon revérifier le fichier.

Entrées associées

#

Vous voyez une erreur ou il manque un exemple ? Écrivez-nous.