Foco e navegação com Tab
O tabindex é um atributo do HTML (HyperText Markup Language) que permite tornar um elemento focalizável e definir sua participação na navegação sequencial, normalmente feita com Tab. O foco identifica o elemento que recebe os eventos de teclado. Poder receber foco por código e aparecer na sequência de Tab são comportamentos distintos.
Com tabindex="0", o elemento participa da ordem do documento junto dos controles que já recebem foco. Um valor negativo, normalmente -1, o retira dessa sequência e permite direcionar o foco por JavaScript. Isso é útil para uma mensagem que precisa receber atenção após uma interação, mas não deve ser visitada a cada passagem de Tab.
Levar o foco até uma mensagem de erro
O exemplo didático parte de uma mensagem já inserida e visível no documento após uma validação malsucedida. O atributo permite que o parágrafo receba foco:
<p id="erro-email" tabindex="-1"> Informe um endereço de email válido.</p>Depois de exibir essa mensagem, o código da validação pode localizar o elemento e chamar seu método focus():
const mensagem = document.getElementById('erro-email');mensagem?.focus();O foco é direcionado ao parágrafo quando ele existe e pode ser focalizado. O operador ?. evita a chamada quando a busca não encontra o elemento. O exemplo não valida o endereço nem cria a mensagem: ele mostra somente o direcionamento do foco. Você precisa executar essa parte no momento adequado da validação.
Preservar a ordem dos controles
Os valores positivos colocam elementos na sequência por ordem numérica, com prioridade sobre os de valor zero. A MDN recomenda usar apenas 0 e -1 e organizar o documento numa sequência lógica. Teste o percurso com Tab e Shift+Tab para conferir se o foco acompanha a ordem de leitura.
Adicionar tabindex a uma div também não implementa as ações de um botão. Um button habilitado já oferece comportamento de teclado e semântica próprios. Use o elemento nativo para essa função e confira o foco visível durante a navegação.
Dúvidas frequentes
Perguntas frequentes sobre tabindex
- É necessário colocar tabindex em todos os botões?
- Um button visível e habilitado normalmente já participa da navegação pelo teclado. Adicionar tabindex com um valor negativo retira esse controle da sequência de Tab, portanto o atributo só deve ser usado para alterar o comportamento padrão.
- Por que evitar valores positivos?
- Eles têm prioridade sobre os elementos com valor zero. Ao numerar os controles, você cria uma ordem que pode divergir da leitura da página e fica mais difícil de manter quando a interface muda.
- Uma div com tabindex funciona como botão?
- O atributo permite receber foco, mas não fornece a semântica nem as ações de teclado de um botão. Use button para uma ação de botão e preserve seu comportamento nativo.
Para continuar
Recursos relacionados
Documentação
MDN: atributo tabindex
Explica os valores negativos, zero e positivos e os cuidados com a ordem de navegação pelo teclado.
Abrir recursoSite de referência
Dev Side Studio: Desenvolvimento Colaborativo
Orientação técnica ao vivo para você revisar o percurso do teclado e o direcionamento do foco nos formulários da aplicação.
Abrir recursoAplicação na formação
Vibe Coding: Do Zero ao MVP
Na revisão de uma interface, você percorre o formulário pelo teclado e confere o destino do foco após uma falha de preenchimento.
Conhecer a formação
Fontes consultadas
Referências deste verbete
Este verbete ajudou você?
Obrigado pela resposta. Ela fica salva apenas neste navegador.