Texto Focável

Saiba como estamos usando 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.

Exemplo de Falha ❌

O price and description text are hidden from assistive technology

TalkBack pula de "Fones de Ouvido Premium" direto para "Adicionar ao Carrinho" — o preço e a descrição nunca são anunciados

Usuários de leitores de tela perdem informações críticas do produto exibidas na tela

Exemplo de Sucesso ✅

Todos os elementos de texto são available to assistive technology e acessíveis pelo TalkBack

O TalkBack navega através de todos os quatro elementos em sequência: cabeçalho, preço, descrição e botão

Usuários de leitores de tela recebem todas as informações do produto em uma ordem de leitura lógica

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" em elementos de texto
• No Compose, não marque 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" em elementos de texto. Se este atributo estiver presente, remova-o ou defina-o como "yes" ou "auto".

Compose

Não marque 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} diretamente no elemento Text, ou a propriedade importantForAccessibility='no-hide-descendants' em um elemento pai.

Flutter

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

Posso Ignorar Esta Regra?

Texto Focalizável tem um impacto crítico para usuários, e recomendamos fortemente corrigir esses problemas. Em casos onde o texto está contido dentro de um elemento pai que já é focalizável pelo TalkBack e já inclui o texto em seu nome acessível - como o rótulo de um botão ou o texto descritivo de um controle - pode ser aceitável deixar o elemento de texto em si não focalizá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
  • Compreendendo 1.3.2 A - Sequência Significativa