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

Valores de Tab
Teclaevent.codeevent.keykeyCodeevent.location
TabTabTab90 (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.

Pressione aqui

Clique aqui e pressione Tab

Está usando só o teclado? Pressione Esc e depois Tab para sair da caixa de teclas.

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.

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.