Código da tecla Control
As duas teclas Ctrl enviam event.key "Control" e keyCode 17. Só event.code e event.location dizem qual é a esquerda e qual é a direita.
Todos os valores de relance
| Tecla | event.code | event.key | keyCode | event.location |
|---|---|---|---|---|
| Ctrl esquerdo | ControlLeft | Control | 17 | 1 (Lado esquerdo) |
| Ctrl direito | ControlRight | Control | 17 | 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 Control
Está usando só o teclado? Pressione Esc e depois Tab para sair da caixa de teclas.
Código para reagir a Ctrl esquerdo
document.addEventListener('keydown', (event) => {
if (event.key === 'Control') {
// Seu código aqui
}
});document.addEventListener('keydown', (event) => {
if (event.code === 'ControlLeft') {
// Seu código aqui
}
});document.addEventListener('keydown', (event) => {
if (event.keyCode === 17) {
// Seu código aqui
}
});Qual valor usar
Para atalhos, confira event.ctrlKey no keydown da outra tecla. Ele é true enquanto qualquer uma das teclas Ctrl está pressionada, então você não precisa acompanhar o Ctrl.
Para reagir ao próprio Ctrl, confira event.key === 'Control'. As duas teclas o enviam, com keyCode 17. Use event.code (ControlLeft ou ControlRight) ou event.location (1 esquerda, 2 direita) para diferenciá-las. Muitos notebooks nem têm o Ctrl direito.
No Mac, a tecla chamada control envia os mesmos valores. Mas os atalhos do Mac usam o Cmd, que é metaKey, não ctrlKey.
O que costuma dar errado
O atalho funciona no Windows, mas não no Mac
Quem usa Mac aperta Cmd + S, não Ctrl + S. Aceite os dois:
if ((event.ctrlKey || event.metaKey) && event.key.toLowerCase() === 's') {
event.preventDefault();
save();
}
Mostre também o nome certo: Ctrl + S no Windows e no Linux, Cmd + S ou ⌘S no Mac.
O Ctrl dispara quando a pessoa digita @ ou € com o AltGr
No Windows, o AltGr funciona como Ctrl e Alt juntos. O Chrome e o Edge enviam primeiro um keydown de Control esquerdo, depois o Alt direito, e ctrlKey e altKey ficam ambos true na tecla digitada. Um atalho Ctrl + Alt + letra pode então disparar enquanto um usuário polonês digita “ą” ou um alemão digita “@”. Evite atalhos com Ctrl + Alt, ou ignore teclas cujo event.key seja um caractere diferente da letra esperada.
Ctrl+W, Ctrl+T, Ctrl+N ou Ctrl+Tab não podem ser impedidos
O navegador fica com eles: Ctrl + N, Ctrl + T, Ctrl + W, Ctrl + Tab, Ctrl + Page Up e Ctrl + Page Down no Windows. No Chrome e no Edge, a página não recebe keydown. O Firefox pode enviar o keydown, mas, nos dois casos, preventDefault() não impede o navegador. Escolha outros atalhos. Ctrl + S, Ctrl + P e Ctrl + F chegam, e preventDefault() impede a ação do próprio navegador.
Ctrl+clique abre um menu no Mac
No Mac, Control + clique é um clique com o botão direito: o navegador dispara contextmenu. Não use Ctrl + clique para “adicionar à seleção” no Mac. Use Cmd + clique (metaKey) ali, como os apps do Mac.
Ctrl+rolagem dá zoom na página
O Ctrl com a roda do mouse dá zoom, e o gesto de pinça no trackpad também. O Chrome, o Edge e o Firefox o enviam como um evento de roda com Ctrl. Um ouvinte de wheel vê ctrlKey true. Chame preventDefault() nele só se o seu mapa ou canvas tem zoom próprio, e registre-o com { passive: false }.