Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.

View in English Always switch to English

keypress

Obsolète: Cette fonctionnalité n'est plus recommandée. Même si certains navigateurs la prennent encore en charge, elle a peut-être déjà été supprimée des standards du web, est en passe d'être supprimée ou n'est conservée qu'à des fins de compatibilité. Évitez de l'utiliser et mettez à jour le code existant si possible ; consultez le tableau de compatibilité au bas de cette page pour vous aider à prendre votre décision. Sachez que cette fonctionnalité peut cesser de fonctionner à tout moment.

L'évènement keypress est déclenché lorsqu'une touche produisant un caractère est pressée. Cela concerne les touches qui produisent des caractères alphabétiques, des caractères numériques et des signes de ponctuations. Les touches Alt, Shift, Ctrl ou Meta ne sont pas concernées.

Attention : Cet évènement est déprécié et il faudrait plutôt utiliser beforeinput ou keydown.

Interface KeyboardEvent
Remonte sur les parents (bubbles) Oui
Annulable Oui
Action par défaut Cela peut varier : évènement keypress ; ouverture du système de composition du texte ; évènements blur et focus ; évènement DOMActivate Obsolète ; autre évènement.

Exemples

Ajout d'un addEventListener

Dans cet exemple, on affiche la valeur de KeyboardEvent.code lorsqu'on appuie sur une touche :

html
<p>
  Cliquez dans l'iframe pour lui passer le focus puis appuyez sur des touches du
  clavier.
</p>
<p id="log"></p>
js
const log = document.getElementById("log");

document.addEventListener("keypress", logKey);

function logKey(e) {
  log.textContent += ` ${e.code}`;
}

Équivalent onkeypress

js
document.onkeypress = logKey;

Spécifications

Specification
UI Events
# event-type-keypress
HTML
# handler-onkeypress

Compatibilité des navigateurs

Voir aussi