Attribut global HTMLAttributs globaux

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 avec contenteditable. L’événement remonte, donc l’attribut fonctionne aussi sur <form>
Sur cette page

Exemple

#
HTML
<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>
Aperçu

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

#
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 champs number et range. Utile pour les calculs.
  • event.inputType

    Le type de modification, par exemple insertText (saisie d’un caractère), deleteContentBackward (Retour arrière) ou insertFromPaste (collage).
  • event.data

    Le caractère saisi, par exemple "a". Lors d’une suppression de texte, il vaut null.

Plus d’exemples

#
Un curseur avec aperçu de la valeur
HTML
<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>
Aperçu

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

#

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