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.
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
document.addEventListener('keydown', (event) => {
if (event.key === 'Tab') {
// Seu código aqui
}
});document.addEventListener('keydown', (event) => {
if (event.code === 'Tab') {
// Seu código aqui
}
});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.