Code de la touche Alt

Les deux touches Alt envoient keyCode 18 et en général event.key « Alt », mais Alt droite donne « AltGraph » sur beaucoup de claviers européens.

Toutes les valeurs d’un coup d’œil

Valeurs pour Alt
Toucheevent.codeevent.keykeyCodeevent.location
Alt gauche / Option gaucheAltLeftAlt181 (Côté gauche)
Alt Gr / Option droiteAltRightAlt182 (Côté droit)

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 Alt

Vous n’utilisez que le clavier ? Appuyez sur Échap, puis sur Tab, pour quitter la zone de touche.

Code pour réagir à Alt gauche

Recommandé : reconnaître event.key
document.addEventListener('keydown', (event) => {
  if (event.key === 'Alt') {
    // Votre code ici
  }
});
Reconnaître la place de la touche : event.code
document.addEventListener('keydown', (event) => {
  if (event.code === 'AltLeft') {
    // Votre code ici
  }
});
Ancien code qui utilise encore keyCode (obsolète)
document.addEventListener('keydown', (event) => {
  if (event.keyCode === 18) {
    // Votre code ici
  }
});

Quelle valeur utiliser

Pour les raccourcis, vérifiez event.altKey sur le keydown de l’autre touche. Il est vrai tant qu’une des deux touches Alt est maintenue (sous Linux, Firefox peut signaler une Alt droite qui sert d’Alt Gr comme AltGraph). Sur un Mac, la touche option est Alt : mêmes valeurs, même altKey.

Pour réagir à Alt elle-même, vérifiez event.code : AltLeft ou AltRight. Sous Windows et sur un Mac, les deux envoient keyCode 18 (sous Linux, une touche Alt Gr peut envoyer 225), mais event.key n’est pas toujours « Alt » : sur les dispositions avec une touche Alt Gr, comme l’allemand, le français ou le polonais, Alt droite envoie « AltGraph ».

Pour la lettre d’un raccourci Alt, comparez event.code (KeyK), pas event.key. Sur un Mac, Option change le caractère que la touche écrit. Sur un clavier français (AZERTY), KeyQ est la touche A : code désigne la place sur un clavier QWERTY, pas la lettre imprimée.

Ce qui pose problème

Option+A donne event.key « å » sur un Mac

Sur un Mac, Option écrit des caractères en plus : Option + A donne « å » et Option + S donne « ß » sur une disposition américaine, et Option + E est une touche morte (event.key « Dead »). Donc event.key === 'a' ne correspond jamais quand Option est maintenue. Vérifiez event.code === 'KeyA' avec event.altKey.

Alt droite ne compte pas comme Alt

Sous Windows et Linux avec une disposition européenne, Alt droite est Alt Gr. Elle envoie event.key « AltGraph », et, sous Windows, Chrome et Edge envoient avant elle un keydown de Ctrl gauche, avec ctrlKey et altKey tous deux vrais. Traitez Alt Gr comme une touche de saisie, pas comme une touche de raccourci : Alt Gr + 0 écrit « @ » sur un clavier français.

Appuyer sur Alt seule fait sortir le focus de la page

Sous Windows, appuyer sur Alt seule puis la relâcher (ou F10) active le menu : Chrome et Edge mettent le focus sur leur bouton de menu, Firefox affiche sa barre de menus. Les touches suivantes vont au navigateur, pas à votre page. Si votre application utilise Alt seule, appelez event.preventDefault() sur son keydown et son keyup ; cela garde en général le focus dans la page.

Alt+Tab et Alt+F4 n’arrivent jamais

Le système les garde : la page ne reçoit aucun keydown, et rien ne peut les arrêter. Votre page peut voir le keydown d’Alt puis perdre le focus sans son keyup : réinitialisez les touches maintenues sur l’événement blur de la fenêtre.

Alt+lettre ouvre un menu du navigateur

Certains raccourcis Alt + lettre appartiennent au navigateur sous Windows et Linux, comme Alt + D pour la barre d’adresse, Alt + F pour le menu et Alt + Flèche gauche pour Retour. Évitez-les pour vos propres raccourcis.

Codes Alt sous Windows

Maintenir Alt et saisir des chiffres sur le pavé numérique (Alt + 0233 pour « é ») écrit un caractère quand on relâche Alt. La page voit en général chaque chiffre comme un keydown avec altKey vrai. Ne liez pas à des raccourcis les chiffres du pavé numérique avec Alt.