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>
Exemple
#<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>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
#<select onchange="code JavaScript">…</select>Disponible dans le code de l’attribut
#this.value
La valeur du champ ou l’attributvaluede l’option choisie dans la liste.this.checked
trueoufalsedans les cases à cocher et les boutons radio.this.selectedOptions
Les options choisies d’une liste<select>. Vous lisez le texte de la première avecthis.selectedOptions[0].text.this.files
Les fichiers choisis dans<input type="file">, chacun avec un nom, une taille et un type.
Plus d’exemples
#<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>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
onchangela 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
#- oninputExécute du code JavaScript à chaque modification de la valeur d’un champ : après la saisie d’un caractère, un collage de texte ou le déplacement d’un curseur.
- <select>Une liste déroulante dans laquelle l’utilisateur choisit une ou plusieurs options.
- <input>Un champ de formulaire : texte, e-mail, mot de passe, nombre, date, curseur, case à cocher, fichier et bien plus encore.
- onsubmitExécute du code JavaScript juste avant l’envoi d’un formulaire. Permet d’arrêter l’envoi et de traiter les données dans un script.
Vous voyez une erreur ou il manque un exemple ? Écrivez-nous.