Code de la touche Espace
La barre d’espace envoie event.key ' ' (une seule espace), event.code « Space » et keyCode 32.
Toutes les valeurs d’un coup d’œil
| Touche | event.code | event.key | keyCode | event.location |
|---|---|---|---|---|
| Espace | Space | " " | 32 | 0 (Standard) |
keyCode tel que Chrome et Edge l’envoient sous Windows. La colonne Mac (Chrome et Safari sur Mac) et la colonne Firefox n’affichent que les nombres qui diffèrent. Certaines touches diffèrent aussi selon le système, comme le dit le texte plus bas. event.which est toujours le même nombre que keyCode. event.key correspond à une disposition américaine sans Maj.
Appuyez dessus ici
Cliquez ici, puis appuyez sur Espace
Vous n’utilisez que le clavier ? Appuyez sur Échap, puis sur Tab, pour quitter la zone de touche.
Code pour réagir à Espace
document.addEventListener('keydown', (event) => {
if (event.key === ' ') {
// Votre code ici
}
});document.addEventListener('keydown', (event) => {
if (event.code === 'Space') {
// Votre code ici
}
});document.addEventListener('keydown', (event) => {
if (event.keyCode === 32) {
// Votre code ici
}
});Quelle valeur utiliser
Vérifiez event.key === ' ', une chaîne qui contient une seule espace. event.key === 'Space' n’est jamais vrai : key contient ce que la touche tape, et la barre d’espace tape une espace.
event.code === 'Space' désigne la touche elle-même. Utilisez-le pour les jeux et les raccourcis, où la place de la touche compte. Il est identique sur toutes les dispositions.
keyCode vaut 32 dans tous les navigateurs, comme le code du caractère espace, mais il est obsolète. Internet Explorer et Firefox 36 et les versions précédentes envoyaient "Spacebar" comme key : n’acceptez cette valeur que si vous gérez encore ces navigateurs.
Ce qui pose problème
Appuyer sur Espace fait défiler la page
Espace fait défiler d’un écran vers le bas et Maj + Espace d’un écran vers le haut, quand aucun élément ayant le focus ne l’utilise. Arrêtez-le dans keydown, là où le défilement commence. Laissez les champs de texte tranquilles, sinon personne ne peut taper d’espace :
if (event.code === 'Space' && !event.target.closest('input, textarea, [contenteditable]')) {
event.preventDefault();
}Espace clique sur le bouton qui a encore le focus
Après un clic sur un bouton, il garde le focus, et Espace l’active de nouveau. Un jeu qui fait sauter avec Espace redémarre ou se met aussi en pause. Déplacez le focus (button.blur()) ou appelez preventDefault() sur Espace pendant que le jeu tourne.
Le bouton réagit au keyup, pas au keydown
Les boutons réagissent à Entrée dès qu’elle est enfoncée, mais à Espace seulement quand elle remonte. Maintenir Espace ne répète pas le clic. Si votre propre élément role="button" gère les touches, copiez ce comportement : Entrée au keydown, Espace au keyup.
Espace choisit un mot en saisie japonaise ou chinoise
Avec une méthode de saisie, Espace convertit les sons tapés en caractères. Votre gestionnaire la voit avec isComposing à true ou keyCode 229. Ignorez ces cas :
if (event.isComposing || event.keyCode === 229) return;Le gestionnaire voit key valant " " mais le texte n’affiche rien
C’est normal : la valeur est bien une seule espace, donc elle semble vide quand vous l’affichez. Affichez JSON.stringify(event.key) dans la console pour voir " ".
Espace sur téléphone
Les claviers Android envoient souvent keyCode 229 et key "Unidentified" pour la barre d’espace, comme pour la plupart des touches. Pour réagir à une espace tapée dans un champ, lisez plutôt event.data === ' ' dans l’événement input.