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
| Tecla | event.code | event.key | keyCode | event.location |
|---|---|---|---|---|
| Shift esquerdo | ShiftLeft | Shift | 16 | 1 (Lado esquerdo) |
| Shift direito | ShiftRight | Shift | 16 | 2 (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
document.addEventListener('keydown', (event) => {
if (event.key === 'Shift') {
// Seu código aqui
}
});document.addEventListener('keydown', (event) => {
if (event.code === 'ShiftLeft') {
// Seu código aqui
}
});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.