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

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.

Sources