CKTIS / HTML
onbeforeinput — gérer un événement avant la modification
onbeforeinput est un attribut de gestion d’événement associé à beforeinput, qui concerne la modification de données par l’utilisateur. Il permet d’exécuter du JavaScript avant un changement et d’annuler l’opération par défaut lorsque l’événement peut être annulé.
Version : WHATWG HTML Living Standard; index snapshot date recorded separately
Syntaxe
onbeforeinput="JavaScript statements"
element.onbeforeinput = function (event) { /* ... */ };onbeforeinput est un attribut HTML contenant le code de gestion de l’événement beforeinput. Il est disponible sur tous les éléments HTML ; son ajout ne rend pas à lui seul un élément modifiable. Son équivalent JavaScript est la propriété element.onbeforeinput.
Dans le code de l’attribut, event désigne l’événement en cours. L’appel à event.preventDefault() permet de bloquer l’opération par défaut uniquement lorsque event.cancelable vaut true. Ne partez pas du principe que tout changement peut être arrêté de cette manière.
La valeur de l’attribut est du code JavaScript, et non un nom d’événement. L’exemple vérifie la gestion et l’annulation d’un événement beforeinput déclenché artificiellement ; il ne simule pas une saisie réelle. La valeur ABC inchangée ne prouve donc pas que la modification native a été bloquée.
Exemples
<!doctype html>
<meta charset="utf-8">
<title>onbeforeinput</title>
<input id="editor" value="ABC" onbeforeinput="if (event.cancelable) event.preventDefault()">
<pre id="result"></pre>
<script>
const editor = document.getElementById('editor');
const event = new Event('beforeinput', { bubbles: true, cancelable: true });
const allowed = editor.dispatchEvent(event);
document.getElementById('result').textContent =
`allowed=${allowed}\ndefaultPrevented=${event.defaultPrevented}\nvalue=${editor.value}`;
</script>Résultat
allowed=false defaultPrevented=true 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.