Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / HTML

oninput — gérer l’événement input

L’attribut oninput contient du code JavaScript exécuté lors de l’événement input. Dans un champ de texte, il permet de réagir aux modifications de l’utilisateur sans attendre qu’il quitte le champ.

Version : WHATWG HTML Living Standard; index snapshot date recorded separately

Syntaxe

oninput="JavaScript statements"

oninput est un attribut de contenu de gestionnaire d’événement pour input, disponible sur tous les éléments HTML. Sa valeur est le corps d’une fonction JavaScript, et non simplement un nom d’événement ou une déclaration de fonction. La disponibilité de l’attribut ne signifie pas que chaque élément génère lui-même ces événements.

Dans un champ de texte, input signale les modifications de la valeur par l’utilisateur, par exemple lorsqu’il saisit, colle ou supprime du texte. Contrairement à change, cet événement n’attend pas que la modification soit validée, ce qui, pour un champ de texte, se produit généralement lorsque le champ perd le focus. Affecter une valeur à value en JavaScript ne déclenche pas automatiquement input.

Dans le code de l’attribut, this désigne l’élément qui gère l’événement, et event donne accès à l’objet événement. Il existe aussi une propriété JavaScript, element.oninput : lui affecter une fonction remplace la fonction existante pour ce gestionnaire ; lui affecter null le désactive.

L’exemple copie la valeur actuelle de this.value dans textContent de l’élément de résultat. La Content Security Policy (CSP) peut bloquer le code inline ; l’exécution de cet exemple nécessite que les gestionnaires d’événements inline soient autorisés.

Exemples

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>oninput example</title>
<label>Text: <input type="text" oninput="document.getElementById('result').textContent = this.value"></label>
<p>Value: <output id="result"></output></p>
</html>

Résultat

Value: abc

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources