---
title: "Código da tecla Tab: keyCode 9, event.key \"Tab\" (JavaScript)"
description: "A tecla Tab em JavaScript envia event.key \"Tab\", event.code \"Tab\" e keyCode 9. Aperte para conferir e trate Shift+Tab sem prender quem usa o teclado."
url: https://devicetests.com/pt-br/keycode/tab
language: pt-BR
---

# Código da tecla Tab

A Tab envia event.key "Tab", event.code "Tab" e keyCode 9, com ou sem Shift.

## Todos os valores de relance

| Tecla | event.code | event.key | keyCode | event.location |
| - | - | - | - | - |
| Tab | `Tab` | `Tab` | 9 | 0 (Padrão) |

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 Tab

Recomendado: identificar por event.key

```
document.addEventListener('keydown', (event) => {
  if (event.key === 'Tab') {
    // Seu código aqui
  }
});
```

Identificar pelo lugar da tecla: event.code

```
document.addEventListener('keydown', (event) => {
  if (event.code === 'Tab') {
    // Seu código aqui
  }
});
```

Código antigo que ainda usa keyCode (obsoleto)

```
document.addEventListener('keydown', (event) => {
  if (event.keyCode === 9) {
    // Seu código aqui
  }
});
```

## Qual valor usar

Verifique `event.key === 'Tab'`. Existe uma só tecla Tab, e ela envia o mesmo valor em todos os layouts. `event.code` também é `"Tab"`.

Shift + Tab também envia `"Tab"`: o Shift não muda o nome da tecla. Verifique `event.shiftKey` para separar os dois casos.

`keyCode` 9 ainda chega em todos os navegadores, mas está obsoleto.

## O que costuma dar errado

### O keyup chega em outro elemento

A Tab move o foco no keydown. Então o keydown vai para o campo que você deixou e o keyup vai para o campo onde você chegou. Um keyup em um campo vê a Tab toda vez que alguém chega nele com a Tab. Trate a Tab no keydown.

### Usuários de teclado ficam presos no meu componente

Se você chama `preventDefault()` na Tab, o foco nunca se move, e quem usa o teclado não consegue sair. Sem outra saída, isso falha no critério 2.1.2 da WCAG, “Sem bloqueio do teclado”. Só impeça a Tab por um bom motivo, como uma janela modal que mantém o foco dentro enquanto está aberta. Aí ofereça uma saída clara: Esc ou um botão de fechar.

### A Tab no meu textarea sai do campo em vez de recuar o texto

Esse é o comportamento padrão, e a maioria dos usuários o quer. Em um editor de código, você pode inserir uma tabulação no lugar:

```
if (event.key === 'Tab' && !event.shiftKey) {
  event.preventDefault();
  textarea.setRangeText('\t', textarea.selectionStart, textarea.selectionEnd, 'end');
}
```

Combine isso com uma saída, como faz a nossa ferramenta de keycode: aperte Esc primeiro, e a Tab passa a seguir adiante. `setRangeText()` não entra no histórico de desfazer. `document.execCommand('insertText', false, '\t')` entra, mas está obsoleto.

### Ctrl+Tab e Alt+Tab nunca chegam à página

O navegador e o computador ficam com elas: Ctrl + Tab troca de aba do navegador, Alt + Tab (Cmd + Tab no Mac) troca de app. Sua página pode ver o keydown da Ctrl ou da Alt e depois nada. Quando o usuário volta, um modificador pode parecer preso, porque o keyup dele foi para outra janela. Zere o estado dos modificadores no evento `blur` da janela.

### No Safari, a Tab pula links e botões

Por padrão, o Safari no Mac se move só entre campos de formulário. Option + Tab alcança todos os itens, ou ative “Pressionar Tabulação para destacar cada item em uma página web” no painel Avançado dos ajustes do Safari. Teste a ordem da Tab com essa opção ligada e não suponha que usuários de Mac alcançam um botão só com a Tab.

## Ordem da Tab

A Tab segue a ordem dos elementos no HTML. `tabindex="0"` coloca um elemento nessa ordem e `tabindex="-1"` o tira. Evite números positivos: eles pulam à frente de tudo e confundem as pessoas.

## Teclas relacionadas

- [Código da tecla Shift](https://devicetests.com/pt-br/keycode/shift)
- [Código da tecla Escape](https://devicetests.com/pt-br/keycode/escape)
- [Código da tecla Enter](https://devicetests.com/pt-br/keycode/enter)
- [Código da tecla de espaço](https://devicetests.com/pt-br/keycode/space)
- [Código da tecla Control](https://devicetests.com/pt-br/keycode/control)
- [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)
