Texto Focável

Saiba como estamos utilizando inteligência artificial para esta regra!

O Que Verificamos

Todos os elementos que contêm texto devem ser focáveis para tecnologias assistivas, como o TalkBack. Os elementos de texto não devem ser ocultos da tecnologia assistiva, para que os usuários possam navegar e ler o texto na tela.

Em Resumo

• Esta regra tem um impacto crítico para os usuários
• Os elementos de texto não devem ser ocultos da tecnologia assistiva para que o TalkBack possa lê-los
• No XML, não defina importantForAccessibility="no" nos elementos de texto
• No Compose, não marque os elementos de texto como invisibleToUser()
• No React Native, os elementos de texto são acessíveis por padrão; assim, não os oculte da tecnologia assistiva

Impacto para os Usuários

Pessoas com cegueira ou baixa visão são as mais impactadas. Quando um elemento de texto é oculto da acessibilidade, o TalkBack não pode focar nele. Como resultado, os usuários de leitores de tela perderão informações exibidas na tela, o que pode causar confusão ou impedir o acesso a conteúdos importantes.

Confirmar Problema de Texto Focável

1. Ligue o TalkBack
2. Tente focar no elemento de texto
3. Uma das seguintes coisas acontecerá:
   • Inacessível: O elemento de texto não será focável pelo TalkBack
   • Acessível: O elemento de texto é focado e lido pelo TalkBack

Corrigir Problemas

Para resolver um problema de Texto Focável, certifique-se de que o elemento de texto não está explicitamente oculto da tecnologia assistiva. Se o texto fizer parte de um elemento pai focável (como um botão ou controle rotulado), o nome acessível do pai deve incluir o texto. Nesse caso, o elemento de texto em si não precisa ser individualmente focável.

XML

Não defina a propriedade importantForAccessibility para "no" nos elementos de texto. Se esse atributo estiver presente, remova-o ou defina-o como "yes" ou "auto".

Compose

Não marque os elementos de texto do Compose como invisibleToUser(). Remova este modificador para garantir que o elemento esteja disponível para o TalkBack.

Text("Digital equality for all.", modifier = Modifier.semantics {
    // Remove invisibleToUser() to make this element accessible to TalkBack
    invisibleToUser()
})

React Native

No React Native, os elementos de texto são acessíveis por padrão. Confirme que o texto é significativo e fornece contexto. Não desative a acessibilidade usando a propriedade accessible={false} no elemento Texto diretamente, ou a propriedade importantForAccessibility='no-hide-descendants' em um elemento pai.

Flutter

No Flutter, Text os elementos são incluídos na árvore de acessibilidade por padrão. Confirme que o texto é significativo e fornece contexto. Não exclua o texto visível da árvore de acessibilidade ao envolver em ExcludeSemantics ou Semantics(excludeSemantics: true).

Posso Ignorar Esta Regra?

Texto Focável tem um impacto crítico para os usuários, e recomendamos fortemente corrigir esses problemas. Nos casos em que o texto está contido em um elemento pai que já é focável pelo TalkBack e já inclui o texto em seu nome acessível - como um rótulo de botão ou um texto descritivo de um controle - pode ser aceitável deixar o elemento de texto em si não focável. Saiba mais sobre ignorar regras.

Recursos

Páginas do Curso da Deque University

• 1.3.2 Sequência Significativa (A)

Nota: O acesso completo aos recursos da Deque University requer assinatura.

Outros Recursos

• Diretrizes de Acessibilidade para Conteúdo Web (WCAG) 2.0, Recomendação do W3C
  • Critério de Sucesso 1.3.2 - Sequência Significativa
• Entendendo os Documentos do WCAG 2.0
  • Entendendo 1.3.2 A - Sequência Significativa