Código da tecla Alt

As duas teclas Alt enviam keyCode 18 e em geral event.key "Alt", mas o Alt direito é "AltGraph" em muitos layouts europeus e no ABNT2.

Todos os valores de relance

Valores de Alt
Teclaevent.codeevent.keykeyCodeevent.location
Alt esquerdo / Option esquerdoAltLeftAlt181 (Lado esquerdo)
Alt direito / Option direitoAltRightAlt182 (Lado direito)

keyCode como o Chrome e o Edge enviam no Windows. A coluna do Mac (Chrome e Safari no Mac) e a do Firefox mostram só os números diferentes; algumas teclas também mudam conforme o sistema, como diz o texto abaixo. event.which é sempre o mesmo número do keyCode. event.key vale para um layout dos EUA sem Shift.

Pressione aqui

Clique aqui e pressione Alt

Está usando só o teclado? Pressione Esc e depois Tab para sair da caixa de teclas.

Código para reagir a Alt esquerdo

Recomendado: identificar por event.key
document.addEventListener('keydown', (event) => {
  if (event.key === 'Alt') {
    // Seu código aqui
  }
});
Identificar pelo lugar da tecla: event.code
document.addEventListener('keydown', (event) => {
  if (event.code === 'AltLeft') {
    // Seu código aqui
  }
});
Código antigo que ainda usa keyCode (obsoleto)
document.addEventListener('keydown', (event) => {
  if (event.keyCode === 18) {
    // Seu código aqui
  }
});

Qual valor usar

Para atalhos, confira event.altKey no keydown da outra tecla. Ele é true enquanto qualquer uma das teclas Alt está pressionada (no Linux, o Firefox pode informar como AltGraph um Alt direito que funciona como AltGr). No Mac, a tecla option é o Alt: mesmos valores, mesmo altKey.

Para reagir ao próprio Alt, confira event.code: AltLeft ou AltRight. No Windows e no Mac, as duas enviam keyCode 18 (no Linux, uma tecla AltGr pode enviar 225), mas event.key nem sempre é "Alt": em layouts com tecla AltGr, como o alemão, o francês ou o polonês, o Alt direito envia "AltGraph".

Para a letra de um atalho com Alt, compare com event.code (KeyK), não com event.key. No Mac, o Option muda o caractere que a tecla digita.

O que costuma dar errado

Option+A dá event.key “å” no Mac

No Mac, o Option digita caracteres extras: Option + A é “å” e Option + S é “ß” num layout US, e Option + E é uma tecla morta (event.key “Dead”). Por isso event.key === 'a' nunca confere com o Option pressionado. Confira event.code === 'KeyA' junto com event.altKey.

O Alt direito não conta como Alt

No Windows e no Linux com layout europeu ou ABNT2, o Alt direito é o AltGr. Ele envia event.key “AltGraph” e, no Windows, o Chrome e o Edge enviam um keydown de Control esquerdo antes dele, com ctrlKey e altKey ambos true. Trate o AltGr como tecla de digitação, não de atalho: AltGr + Q digita “@” num teclado alemão.

Apertar só o Alt tira o foco da página

No Windows, apertar e soltar só o Alt (ou o F10) é a tecla de menu: o Chrome e o Edge dão foco ao botão de menu, e o Firefox mostra a barra de menus. As próximas teclas vão para o navegador, não para a sua página. Se o seu app usa o Alt sozinho, chame event.preventDefault() no keydown e no keyup dele. Isso costuma manter o foco na página.

Alt+Tab e Alt+F4 nunca chegam

O sistema fica com eles, então a página não recebe keydown, e nada consegue impedi-los. Sua página pode ver o keydown do Alt e depois perder o foco sem o keyup: zere as teclas pressionadas no evento blur da janela.

Alt+letra abre um menu do navegador

Alguns atalhos Alt + letra são do navegador no Windows e no Linux, como Alt + D para a barra de endereços, Alt + F para o menu e Alt + Seta para a esquerda para Voltar. Evite-os nos seus atalhos.

Códigos Alt no Windows

Segurar o Alt e digitar números no teclado numérico (Alt + 0233 para “é”) digita um caractere quando o Alt é solto. A página em geral vê cada dígito como um keydown com altKey true. Não ligue atalhos ao Alt com dígitos do teclado numérico.