CKTIS / HTML
onkeydown — gérer l’appui sur une touche
L’attribut onkeydown contient du code JavaScript qui gère l’événement keydown. Il permet de réagir à l’appui sur une touche ; l’objet event fournit les données de l’événement. Ce n’est pas un attribut booléen.
Version : WHATWG HTML Living Standard; index snapshot date recorded separately
Syntaxe
onkeydown="JavaScript statements"onkeydown est un attribut HTML de gestion de l’événement keydown. Sa valeur est le corps d’une fonction JavaScript, et non un nom d’événement ou une URL. Écrire simplement le nom d’une fonction sans l’appeler ne l’exécute pas.
Dans le code de l’attribut, le paramètre event fournit l’événement. L’attribut HTML onkeydown="…" et la propriété JavaScript element.onkeydown configurent le même mécanisme de gestion. Affecter une nouvelle fonction à la propriété remplace le gestionnaire existant.
return false annule l’action par défaut de l’événement si celui-ci peut être annulé, mais n’interrompt pas sa propagation. Une Content Security Policy peut bloquer les gestionnaires écrits directement dans les attributs. N’insérez jamais de texte non fiable dans l’attribut sous forme de code.
Exemples
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>onkeydown example</title>
<button type="button" onkeydown="if (event.key === 'Enter') document.getElementById('result').textContent = 'Enter';">Focus here; press Enter</button>
<p id="result" aria-live="polite">Waiting</p>
</html>Résultat
Enter
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.