CKTIS / HTML
onkeypress — attribut de gestion de l’événement keypress
L’attribut HTML global onkeypress contient du code JavaScript qui gère l’événement keypress. Le nom de l’attribut comporte le préfixe on ; le nom de l’événement, lui, ne le comporte pas.
Version : WHATWG HTML Living Standard; index snapshot date recorded separately
Syntaxe
onkeypress="JavaScript statements"onkeypress est un attribut global de gestion d’événements disponible sur les éléments HTML. Sa valeur est du code JavaScript, et non un nom d’événement ou une valeur booléenne. keypress est un événement hérité et obsolète sur lequel il ne faut pas s’appuyer dans du nouveau code.
L’attribut onkeypress et la propriété JavaScript element.onkeypress exposent le même mécanisme de gestion pour keypress. Écris du code dans l’attribut ; affecte une fonction ou null à la propriété. Le paramètre event rend l’événement accessible au code exécuté.
Une Content Security Policy peut bloquer les gestionnaires écrits directement dans les attributs. N’insère pas de texte non fiable comme du code dans leurs valeurs.
L’exemple déclenche keypress par programmation pour montrer que le gestionnaire s’exécute sans frappe manuelle. Le texte attendu est keypress ; ce test ne détermine pas à quel moment un navigateur génère l’événement keypress lors d’une saisie réelle.
Exemples
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>onkeypress demo</title>
<input id="field" aria-label="Text" onkeypress="document.getElementById('result').textContent = event.type">
<output id="result"></output>
<script>
document.getElementById('field').dispatchEvent(
new KeyboardEvent('keypress', { key: 'a' })
);
</script>
</html>Résultat
keypress
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.