CKTIS / HTML
onchange — gérer un événement change
L’attribut onchange contient du JavaScript exécuté lors d’un événement change. Pour les contrôles de formulaire, cet événement correspond à une modification validée par l’utilisateur, pas nécessairement à chaque édition de la valeur.
Version : WHATWG HTML Living Standard; index snapshot date recorded separately
Syntaxe
onchange="JavaScript statements"onchange est un attribut de contenu de gestionnaire d’événement pour change. Sa valeur est le corps d’une fonction JavaScript, et non une URL de script. Cet attribut est disponible sur tous les éléments HTML, mais sa simple présence ne suffit pas à faire émettre change par un élément.
Le moment où l’événement se produit dépend du contrôle. Une case à cocher émet change lorsque l’utilisateur la bascule ; un champ texte le fait généralement lorsque la valeur modifiée est validée en quittant le champ. Utilisez input pour réagir aux modifications en cours. Affecter .value ou .checked en JavaScript n’émet pas automatiquement change.
Dans le code de l’attribut, this désigne l’élément qui traite l’événement, et event fournit l’objet événement. L’équivalent JavaScript est la propriété element.onchange ; une nouvelle affectation remplace la fonction précédente de ce mécanisme. element.addEventListener('change', handler) permet d’enregistrer des écouteurs indépendants. Une politique Content Security Policy peut bloquer le code des attributs ; dans ce cas, utilisez un script autorisé avec addEventListener().
Exemples
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>onchange example</title>
<label>
<input type="checkbox" onchange="document.getElementById('state').textContent = this.checked ? 'ON' : 'OFF'">
Enabled
</label>
<p id="state" role="status">OFF</p>
</html>Résultat
OFF → ON → OFF
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.