Códigos das teclas de seta

As setas enviam event.key "ArrowLeft", "ArrowUp", "ArrowRight" e "ArrowDown", e keyCode 37, 38, 39 e 40.

Todos os valores de relance

Valores de Teclas de seta
Teclaevent.codeevent.keykeyCodeevent.location
Seta para a esquerdaArrowLeftArrowLeft370 (Padrão)
Seta para cimaArrowUpArrowUp380 (Padrão)
Seta para a direitaArrowRightArrowRight390 (Padrão)
Seta para baixoArrowDownArrowDown400 (Padrão)

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 uma tecla de seta

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

Código para reagir a Seta para a esquerda

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

Qual valor usar

Confira event.key. As setas não mudam com o layout do teclado, então key e code têm os mesmos nomes: ArrowLeft, ArrowUp, ArrowRight e ArrowDown.

Use event.code quando o teclado numérico não deve contar. Com o Num Lock desligado, as teclas 4, 8, 6 e 2 do teclado numérico também enviam key “ArrowLeft”, “ArrowUp”, “ArrowRight” e “ArrowDown” e keyCode 37 a 40. Só o code delas (Numpad4, Numpad8, Numpad6, Numpad2) e o location 3 as entregam.

Os números antigos começam na seta para a esquerda e seguem em volta: 37 esquerda, 38 cima, 39 direita, 40 baixo. Todos os navegadores ainda os enviam, mas eles são obsoletos.

O que costuma dar errado

A página rola quando o jogador aperta uma seta

A rolagem é a ação padrão das setas. Chame event.preventDefault() no keydown. Escute no próprio jogo (dê a ele tabindex="0") em vez de na window, para o resto da página continuar rolando e os campos de texto continuarem movendo o cursor:

game.addEventListener('keydown', (event) => {
  if (event.key.startsWith('Arrow')) event.preventDefault();
});

O movimento engasga, ou uma direção trava

Uma tecla segurada envia um keydown, depois uma pausa e depois repete na velocidade de repetição da pessoa. Mover a cada keydown engasga. Em vez disso, guarde um conjunto de teclas seguradas: adicione event.code no keydown, remova no keyup e mova no loop do jogo. Esvazie o conjunto no evento blur da janela: se a pessoa troca de janela segurando uma tecla, o keyup dela nunca chega à sua página.

Código antigo procura “Left” ou “Up”

O Internet Explorer, o Edge 16 e anteriores e o Firefox 36 e anteriores enviavam "Left", "Up", "Right" e "Down". Os navegadores atuais enviam os nomes com Arrow. Confira os dois só se você ainda dá suporte a esses navegadores.

Seu tratador de setas briga com um controle deslizante, uma lista ou um campo de texto

Muitos elementos usam as setas por conta própria: campos de texto movem o cursor, controles deslizantes mudam o valor, botões de opção e <select> mudam a escolha. Ignore eventos cujo event.target seja um desses, ou deixe que eles tratem a tecla primeiro e confira event.defaultPrevented.

Teclados de Mac e de notebook

Notebooks Mac e muitos teclados pequenos não têm as teclas Home, End, Page Up e Page Down. No Mac, segure Fn com uma seta: Fn + esquerda envia Home, Fn + direita envia End, Fn + cima envia Page Up e Fn + baixo envia Page Down. A página recebe essas teclas, não uma seta.

No Mac, o keyup de uma seta apertada com a tecla Cmd segurada pode não chegar, em qualquer navegador. Não conte com ele para saber quais teclas estão seguradas.