A navegação por teclado exige que todo elemento clicável seja alcançável com Tab e disparável com Enter, sem mouse. Segundo a WebAIM Million (2024), 95,9% das home pages têm falhas de WCAG 2 detectáveis. Foco invisível e armadilhas de teclado respondem por boa parte delas. Corrija foco, skip link e menus antes de instalar overlay.
A navegação por teclado é o uso do site inteiro apenas com as teclas Tab, Shift+Tab, Enter e setas, sem depender do mouse. No WordPress, ela falha quando o tema esconde o indicador de foco, quando menus só abrem no hover ou quando um overlay prende o cursor. Quem depende disso são usuários com deficiência motora, pessoas que usam leitor de tela e até quem perdeu o mouse no meio de uma compra. Este tutorial mostra os 5 passos técnicos para auditar e corrigir a navegação por teclado do seu site, do skip link ao foco visível. Para o panorama completo do tema, veja o hub de acessibilidade WordPress da FULL.
Diagnóstico rápido: O que quebra a navegação por teclado
Três defeitos respondem pela maioria das falhas de navegação por teclado no WordPress, e os três são corrigíveis sem trocar de tema. O mais comum é o outline:none no :focus, presente em boa parte dos temas comerciais que chegam no suporte: o foco existe, mas some.
Os outros dois são menus que só respondem ao hover e overlays que prendem o cursor. A tabela abaixo cruza o sintoma com a causa raiz no código e a correção. É o mapa que a gente usa nos tickets da FULL antes de abrir qualquer arquivo do tema.
| Sintoma | Causa raiz | Ação corretiva |
|---|---|---|
| Não vejo onde estou ao apertar Tab | outline:none no :focus do CSS | Restaurar :focus-visible com contorno de 2px |
| Submenu não abre sem mouse | Menu depende de :hover | Tratar :focus-within e aria-expanded |
| Tab pula o conteúdo principal | Falta de skip link | Adicionar link “pular para o conteúdo” |
| Fico preso no menu mobile | Overlay sem focus trap correto | Implementar aria-modal e fechar no Esc |
| A ordem do Tab está bagunçada | CSS reposiciona, DOM não acompanha | Alinhar ordem do DOM à ordem visual |
Por que a navegação por teclado falha no WordPress padrão
A navegação por teclado falha porque a maioria dos temas e page builders foi desenhada pensando primeiro no mouse, e o suporte ao teclado vira um detalhe secundário. O caso clássico aparece quando o desenvolvedor troca um nativo por uma
onclick: o elemento parece um botão, mas o Tab nunca chega nele e o Enter nunca o dispara.
Outro mecanismo recorrente é o CSS que reposiciona blocos com flex ou position, fazendo a ordem visual divergir da ordem do DOM. O leitor lê de cima para baixo na tela, mas o Tab segue o DOM, então o foco salta de forma aparentemente aleatória. Pela WAI-ARIA, a regra é direta: prefira elementos nativos a recriar comportamento com role e tabindex. A gente vê no suporte da FULL que devolver semântica nativa resolve a maior parte dos casos antes de qualquer plugin.
Passo a passo: Como corrigir a navegação por teclado em 5 etapas
Corrigir a navegação por teclado em um site WordPress leva entre 2 e 4 horas de trabalho técnico na maioria dos temas, distribuídas em 5 etapas que vão da auditoria ao reteste. A sequência importa: auditar antes de mexer evita que você corrija o que não estava quebrado e ignore o que estava.
Cada etapa abaixo é independente e pode ser validada na hora, apertando Tab no próprio navegador. Comece pela auditoria com Tab manual, que custa zero e revela 80% dos problemas em cinco minutos.
Legenda: o contorno azul mostra o elemento em foco, a referência visual que o usuário de teclado precisa para se localizar.
Passo 1: Audite o site só com a tecla tab
Abra a home no navegador, clique uma vez na barra de endereço e comece a apertar Tab, anotando para onde o foco vai. Você precisa enxergar um contorno em cada link, botão e campo, na mesma ordem em que lê a página. Se o foco some, pula blocos ou trava em algum lugar, você acabou de mapear o defeito. Ferramentas como WAVE e axe DevTools confirmam o achado, mas o Tab manual já revela a maioria dos problemas em poucos minutos.
Passo 2: Restaure o indicador de foco visível
Procure no CSS do tema por outline: none ou outline: 0 aplicado ao estado :focus e remova ou substitua a regra. A correção segura é declarar um :focus-visible com contorno de pelo menos 2px e contraste adequado, que aparece só na navegação por teclado e não polui o clique de mouse. A WCAG 2.2 trata isso no critério Focus Appearance, que pede indicador de foco com área e contraste mínimos. Sem esse contorno, o usuário não tem como saber onde está.
Passo 3: Adicione um skip link no topo do tema
Insira um link “pular para o conteúdo” como primeiro elemento focável do , apontando para o id do conteúdo principal. Ele fica escondido até receber foco, quando aparece no topo da tela. Sem ele, quem usa teclado precisa percorrer dezenas de itens de menu em toda página antes de chegar ao texto. A maioria dos temas sérios, como Astra, já traz skip link nativo; se o seu não tem, o snippet padrão são poucas linhas de HTML e CSS no header.
Passo 4: Corrija menus que só abrem no hover
Abra cada menu suspenso usando apenas Tab e veja se os submenus aparecem. Menus que dependem só de :hover no CSS deixam o submenu invisível para quem navega por teclado. A correção é adicionar :focus-within à regra que exibe o submenu e marcar o item pai com aria-expanded. Em construtores como Elementor, o mega menu costuma abrir só no hover do mouse, então vale testar item por item antes de declarar o menu acessível.
Passo 5: Trate o overlay do menu mobile e modais
Teste o menu mobile e qualquer modal apertando Tab depois de abri-los. Se o foco escapa para o conteúdo atrás do overlay, você tem uma armadilha de teclado ao contrário, e o usuário se perde. A correção combina aria-modal="true", um focus trap que mantém o Tab dentro do overlay e o fechamento pela tecla Esc. Esse é o ponto que mais reaparece nos tickets da FULL, porque o overlay parece funcionar no mouse e ninguém testa o teclado.
Quais ferramentas validam a navegação por teclado
Quatro ferramentas cobrem a validação da navegação por teclado, das gratuitas no navegador às auditorias automatizadas. O WAVE, da WebAIM, marca visualmente elementos sem foco e ordem de tabulação suspeita direto na página, sem instalar nada além da extensão.
O axe DevTools roda dentro do inspetor do Chrome e lista violações de WCAG com o seletor exato do elemento problemático. O Lighthouse, embutido no Chrome, dá uma nota de acessibilidade rápida, embora superficial para teclado. Nenhuma delas substitui o teste manual: a navegação por teclado é, por definição, uma experiência sequencial que só o Tab humano valida de ponta a ponta. As automatizadas pegam o foco invisível e a falta de skip link, mas não percebem quando a ordem do Tab está ilógica ou quando um submenu nunca recebe foco. A gente recomenda no suporte da FULL usar WAVE para o mapa visual, o axe para o detalhe técnico e sempre fechar com o Tab manual nas páginas que mais convertem.
Acelere a acessibilidade do seu WordPress com o bundle FULL
Montar um stack de acessibilidade e SEO com tema premium, plugin de auditoria e ferramentas de performance fica caro quando você soma licença a licença, cada uma com renovação anual própria que pesa no orçamento de quem cuida de vários sites.
No plano PRO da FULL, por R$849 ao ano, você ativa o bundle completo de plugins premium em até 10 sites, o que dá cerca de R$85 por site, com Astra PRO para temas com base acessível e Rank Math PRO para o SEO técnico já incluso. Em vez de pagar cada licença separada e controlar dezenas de renovações ao longo do ano, a gente entrega a stack pronta para ativar num clique, com atualização centralizada em todos os sites do seu painel. Veja os planos da FULL e calcule o custo por site do seu portfólio.
Erros comuns que reintroduzem a falha de teclado
O erro mais frequente é tratar a navegação por teclado como tarefa única em vez de hábito de manutenção, e a falha volta na primeira atualização de tema. Um update sobrescreve o CSS customizado do foco, e o outline:none retorna sem ninguém notar até um usuário reclamar.
O segundo erro é confiar num plugin de overlay de acessibilidade como atalho. Esses overlays adicionam uma camada por cima, mas não corrigem o foco invisível nem a ordem de DOM quebrada por baixo, e em alguns casos pioram, criando uma segunda armadilha de teclado. A correção nativa de foco, skip link e menus continua sendo a base, conforme orienta a própria WAI-ARIA. A gente vê nos tickets que o overlay vira muleta e adia o conserto real, que é simples e definitivo. Para entender onde acessibilidade e otimização se cruzam, vale revisar como melhorar a usabilidade do seu site WordPress.
Perguntas frequentes sobre navegação por teclado no WordPress
É possível navegar em todo o site WordPress só com o teclado?
Sim, quando o tema usa elementos nativos e o foco fica visível. Um site WordPress bem construído permite alcançar todo link, botão e campo apenas com Tab, Shift+Tab e Enter, sem mouse. A barreira mais comum é o CSS com outline:none que esconde o foco; corrigido isso com :focus-visible, a navegação por teclado completa o site de ponta a ponta.
Por que o foco do teclado some ou pula elementos no WordPress?
Porque o CSS do tema esconde o indicador de foco ou reposiciona blocos sem acompanhar a ordem do DOM. O Tab segue a ordem do código, não a ordem visual, então quando o flex ou position muda o layout, o foco parece pular. A correção alinha a ordem do DOM à ordem visual e restaura o contorno de 2px no estado :focus-visible.
Qual a diferença entre navegação por teclado e leitor de tela?
A navegação por teclado é o controle do site só com teclas, enquanto o leitor de tela converte a tela em voz para quem não enxerga. As duas se sobrepõem: um leitor de tela navega por teclado, mas nem todo usuário de teclado usa leitor de tela. Por isso o foco visível importa para quem enxerga e navega só com Tab, um público que o leitor de tela não cobre.
Quanto tempo leva para corrigir a navegação por teclado de um site?
Na maioria dos temas WordPress, entre 2 e 4 horas de trabalho técnico, da auditoria ao reteste. A auditoria com Tab manual leva cinco minutos e revela cerca de 80% dos defeitos. Restaurar foco visível e adicionar skip link são correções de poucas linhas; o tempo maior vai para menus e overlays que dependem de hover e precisam de tratamento de aria-expanded.
O que a WCAG 2.2 exige sobre navegação por teclado?
A WCAG 2.2 exige que toda funcionalidade seja operável por teclado, sem armadilhas, com ordem de foco lógica e indicador de foco visível. O critério Focus Appearance, novo na versão 2.2, pede contorno de foco com área e contraste mínimos. Na prática, isso significa skip link, foco visível de 2px e menus que abrem com Tab, exatamente os pontos deste tutorial.
Próximos passos para garantir a navegação por teclado
Garantir a navegação por teclado no WordPress não é um projeto pontual, é uma rotina de auditoria que acompanha cada atualização de tema e plugin. Comece pelo teste manual com Tab nas páginas que mais convertem, restaure o foco visível, adicione o skip link e só então valide menus e overlays com WAVE e axe DevTools. Em , com a WCAG 2.2 já consolidada e o critério Focus Appearance no radar das auditorias, o foco visível deixou de ser opcional e virou linha de base. Para aprofundar, veja os atalhos de teclado úteis no WordPress, o passo a passo de como adicionar um menu de navegação e, para automatizar parte da auditoria, IA para acessibilidade no WordPress. Garantir que o formulário de contato também responda ao teclado fecha o ciclo. Para continuar aprendendo, o FULL Academy reúne os tutoriais de acessibilidade num só lugar.
















