Código da tecla Shift

As duas teclas Shift enviam event.key "Shift" e keyCode 16. Só event.code e event.location mostram qual é a esquerda e qual é a direita.

Todos os valores de relance

Valores de Shift
Teclaevent.codeevent.keykeyCodeevent.location
Shift esquerdoShiftLeftShift161 (Lado esquerdo)
Shift direitoShiftRightShift162 (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 Shift

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

Código para reagir a Shift esquerdo

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

Qual valor usar

Para saber se o Shift está pressionado durante outra tecla, verifique event.shiftKey. Ele é verdadeiro em todo evento de tecla enquanto qualquer Shift estiver pressionado, e você não precisa acompanhar a tecla Shift por conta própria.

Para reagir ao próprio Shift, verifique event.key === 'Shift'. As duas teclas o enviam, com keyCode 16. Use event.code (ShiftLeft ou ShiftRight) ou event.location (1 esquerda, 2 direita) quando as duas precisarem fazer coisas diferentes.

Nos eventos da própria tecla Shift, shiftKey é verdadeiro no keydown e falso no keyup, porque mostra o estado depois do aperto ou da liberação.

O que costuma dar errado

Ctrl+Shift+Z não combina com event.key === ‘z’

O Shift muda o event.key da outra tecla: “z” vira “Z”, “1” vira “!”. Ele não muda o event.code (KeyZ, Digit1) nem o keyCode (90, 49). Em atalhos de letra com Shift, compare em minúsculas ou use code:

if (event.ctrlKey && event.shiftKey && event.key.toLowerCase() === 'z') redo();

Shift+2 digita @ para você, mas “ para outra pessoa

O símbolo de uma tecla Shift + número depende do layout: Shift + 2 é “@” em um teclado US e ‘“’ em um britânico, e o AZERTY precisa do Shift para digitar os próprios dígitos. Se o seu atalho é um símbolo, verifique event.key para o símbolo e ignore shiftKey. Se é a posição de uma tecla, verifique event.code.

Um Shift continua “pressionado” depois de apertar os dois

No Windows, quando os dois Shift estão pressionados, o sistema pode informar só uma liberação, e o keyup de um dos Shift pode se perder. Se você acompanha cada lado, zere os dois quando qualquer keyup de Shift chegar, ou verifique event.shiftKey no próximo evento de tecla para corrigir o seu estado.

Shift pressionado enquanto a janela perde o foco

O keyup vai então para outra janela. Zere o seu estado do Shift no evento blur da janela, ou confie em event.shiftKey no próximo evento de tecla ou de mouse, em vez da sua própria variável.

Shift com o mouse e em celulares

Eventos de mouse e de ponteiro também trazem shiftKey, então Shift + clique (selecionar um intervalo) não precisa de um ouvinte de teclado. Não espere um evento da tecla Shift no teclado virtual de um celular: o Android costuma informar as teclas como keyCode 229, e a letra maiúscula chega apenas como texto.