O foco que precisa de indicação visual
A pseudoclasse CSS :focus-visible seleciona um elemento que possui foco quando o navegador considera necessário indicar visualmente essa posição. O foco identifica o controle que recebe a interação pelo teclado. Seu indicador permite que você localize, por exemplo, o botão que será acionado com Enter.
O navegador avalia a forma de interação e as preferências de acessibilidade. A navegação por teclado costuma exigir a indicação, mas o comportamento não se resume a distinguir teclado de mouse. Um campo de texto pode precisar do indicador mesmo depois de um clique porque aceita digitação.
Um contorno para os botões
Este exemplo aplica um contorno aos botões que correspondem à pseudoclasse, sem remover os estilos de foco já oferecidos pelo navegador:
button:focus-visible { outline: 3px solid #005fcc; outline-offset: 3px;}Ao percorrer os botões com Tab, você deve encontrar um contorno azul no botão focado quando houver correspondência. O outline define a aparência do contorno e o outline-offset o afasta da borda em três pixels. O seletor não cria foco em um elemento que não o recebe.
Conferir o indicador na página
A pseudoclasse :focus corresponde ao elemento focado independentemente da necessidade de indicação visual. Já :focus-visible permite personalizar a indicação nos casos selecionados pelo navegador. Remover o contorno de :focus sem uma alternativa visível pode deixar a navegação por teclado sem orientação.
Teste o percurso com Tab e Shift+Tab nos controles da página. Confira se o contorno aparece inteiro e se a cor se distingue do fundo. O azul do exemplo exige essa conferência no tema da aplicação, sobretudo quando há fundos escuros.
Dúvidas frequentes
Perguntas frequentes sobre focus-visible
- Qual é a diferença entre :focus e :focus-visible?
- A pseudoclasse :focus corresponde ao elemento que tem foco. A :focus-visible exige também que o navegador considere necessário mostrar esse foco. Ambas podem corresponder ao mesmo elemento.
- Um clique pode ativar :focus-visible?
- Um campo de texto pode corresponder a :focus-visible mesmo após um clique, pois aceita entrada pelo teclado. A avaliação também considera preferências de acessibilidade e pode variar entre navegadores.
- Usar :focus-visible torna qualquer elemento acessível pelo teclado?
- O seletor apenas aplica estilos quando há correspondência. Ele não torna uma div focável nem fornece o comportamento de um botão. Use controles HTML adequados e teste a navegação.
Para continuar
Recursos relacionados
Documentação
MDN: pseudoclasse focus-visible
Referência da MDN com a diferença entre :focus e :focus-visible, exemplos de estilos e cuidados de acessibilidade.
Abrir recursoSite de referência
DevSide: desenvolvimento colaborativo
Orientação ao vivo para investigar a navegação por teclado e revisar o indicador de foco nos controles da sua aplicação.
Abrir recursoAplicação na formação
Vibe Coding: Do Zero ao MVP
Ao revisar uma interface criada com agentes, você precisa testar a navegação por teclado e conferir o indicador de foco dos controles.
Conhecer a formação
Fontes consultadas
Referências deste verbete
Este verbete ajudou você?
Obrigado pela resposta. Ela fica salva apenas neste navegador.