---
title: "Código da tecla Ctrl: keyCode 17, event.key \"Control\" (JavaScript)"
description: "Ctrl em JavaScript: event.key \"Control\", keyCode 17, event.code \"ControlLeft\" ou \"ControlRight\". O Ctrl falso do AltGr, o Cmd do Mac e atalhos bloqueados."
url: https://devicetests.com/pt-br/keycode/control
language: pt-BR
---

# 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.

## 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 }`.

## Teclas relacionadas

- [Código da tecla Alt](https://devicetests.com/pt-br/keycode/alt)
- [Código da tecla Meta (tecla Windows e Command)](https://devicetests.com/pt-br/keycode/meta)
- [Código da tecla Shift](https://devicetests.com/pt-br/keycode/shift)
- [Códigos das teclas de letras (A–Z)](https://devicetests.com/pt-br/keycode/letter-keys)
- [Descobrir o código de uma tecla: pressione qualquer tecla para ver os códigos](https://devicetests.com/pt-br/keycode)
- [Todos os códigos de tecla em uma tabela](https://devicetests.com/pt-br/keycode#key-codes)
