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

Valores de Control
Teclaevent.codeevent.keykeyCodeevent.location
Ctrl esquerdoControlLeftControl171 (Lado esquerdo)
Ctrl direitoControlRightControl172 (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

Recomendado: identificar por event.key
document.addEventListener('keydown', (event) => {
  if (event.key === 'Control') {
    // Seu código aqui
  }
});
Identificar pelo lugar da tecla: event.code
document.addEventListener('keydown', (event) => {
  if (event.code === 'ControlLeft') {
    // Seu código aqui
  }
});
Código antigo que ainda usa keyCode (obsoleto)
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 }.