oninput
Exé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.
- S’applique à
<input>,<textarea>,<select>et éléments aveccontenteditable. L’événement remonte, donc l’attribut fonctionne aussi sur<form>
Exemple
#<label for="bio">Quelques mots sur vous</label>
<textarea id="bio" rows="3" maxlength="80"
oninput="document.getElementById('count').textContent = this.value.length"></textarea>
<p><span id="count">0</span> / 80 caractères</p>Le compteur change à chaque caractère, y compris lors d’un collage ou d’une suppression de texte.
Définition et utilisation
#L’attribut oninput réagit à l’événement input, qui se produit chaque fois que l’utilisateur modifie la valeur d’un champ : saisit ou supprime un caractère, colle du texte, choisit une suggestion, déplace un curseur ou coche une case. Il fonctionne sur les éléments <input>, <textarea> et <select> et sur les éléments avec contenteditable.
C’est le meilleur choix lorsque la page doit réagir en continu : compteur de caractères, aperçu en direct, filtrage d’une liste, indicateur de robustesse d’un mot de passe. C’est ce qui le distingue de onchange, qui dans les champs de texte attend que l’utilisateur valide la valeur. L’événement input remonte dans l’arbre, donc un seul attribut sur un <form> gère tous les champs qu’il contient.
Lorsque l’attribut se trouve sur un champ, this désigne ce champ et this.value sa valeur actuelle, toujours sous forme de texte. Modifier la valeur dans un script, par exemple field.value = "", ne déclenche pas l’événement input. Dans des projets plus importants, ajoutez la gestion dans un script plutôt que dans l’attribut : field.addEventListener("input", …).
Syntaxe
#<input oninput="code JavaScript">Disponible dans le code de l’attribut
#this.value
La valeur actuelle du champ, toujours sous forme de texte.this.valueAsNumber
La valeur convertie en nombre dans les champsnumberetrange. Utile pour les calculs.event.inputType
Le type de modification, par exempleinsertText(saisie d’un caractère),deleteContentBackward(Retour arrière) ouinsertFromPaste(collage).event.data
Le caractère saisi, par exemple"a". Lors d’une suppression de texte, il vautnull.
Plus d’exemples
#<label for="goal">Objectif d’apprentissage quotidien</label>
<input type="range" id="goal" min="5" max="60" step="5" value="15"
oninput="document.getElementById('goal-value').textContent = this.value + ' min'">
<output id="goal-value" for="goal">15 min</output>Avec un curseur, l’événement input se produit tout au long du déplacement, et change seulement une fois la poignée relâchée.
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 de requête au serveur à chaque caractère. Dans une recherche avec suggestions, patientez un instant après la dernière frappe (ce qu’on appelle le debounce).
- Si seule la valeur finale compte, par exemple lors de l’enregistrement de réglages, choisissez
onchange. Le code s’exécutera moins souvent.
Entrées associées
#- onchangeExécute du code JavaScript lorsque l’utilisateur valide une nouvelle valeur du champ : choisit une option, coche une case ou termine sa saisie.
- <input>Un champ de formulaire : texte, e-mail, mot de passe, nombre, date, curseur, case à cocher, fichier et bien plus encore.
- <textarea>Un champ de texte multiligne pour des saisies plus longues : messages, avis, descriptions.
- <output>Le résultat d’un calcul ou d’une action de l’utilisateur, par exemple un total dans une calculatrice.
- onkeydownExécute du code JavaScript au moment de l’appui sur une touche. Sert aux raccourcis clavier et à la gestion de touches comme Entrée ou Échap.
Vous voyez une erreur ou il manque un exemple ? Écrivez-nous.