Tem Papel de Acessibilidade Válido
ID da Regra: tem-papel-de-acessibilidade-válido
accessibilityRole comunica o propósito de um componente para o usuário de tecnologia assistiva.
accessibilityRole pode ser um dos seguintes:
- ajustável Usado quando um elemento pode ser "ajustado" (por exemplo, um controle deslizante).
- alerta Usado quando um elemento contém texto importante a ser apresentado ao usuário.
- botão Usado quando o elemento deve ser tratado como um botão.
- caixa de seleção Usado quando um elemento representa uma caixa de seleção que pode ser marcada, desmarcada ou ter um estado misto.
- caixa combinada Usado quando um elemento representa uma caixa combinada, que permite ao usuário selecionar entre várias opções.
- cabeçalho Usado quando um elemento atua como cabeçalho para uma seção de conteúdo (por exemplo, o título de uma barra de navegação).
- imagem Usado quando o elemento deve ser tratado como uma imagem. Pode ser combinado com um botão ou link.
- botão de imagem Usado quando o elemento deve ser tratado como um botão e também é uma imagem.
- tecla de teclado Usado quando o elemento atua como uma tecla de teclado.
- link Usado quando o elemento deve ser tratado como um link.
- menu Usado quando o componente é um menu de escolhas.
- barra de menus Usado quando um componente é um contêiner de vários menus.
- item de menu Usado para representar um item dentro de um menu.
- nenhum Usado quando o elemento não tem papel.
- barra de progresso Usado para representar um componente que indica o progresso de uma tarefa.
- rádio Usado para representar um botão de seleção.
- grupo de rádio Usado para representar um grupo de botões de seleção.
- barra de rolagem Usado para representar uma barra de rolagem.
- busca Usado quando um elemento de campo de texto também deve ser tratado como um campo de busca.
- botão de rotação Usado para representar um botão que abre uma lista de opções.
- resumo Usado quando um elemento pode ser utilizado para fornecer um resumo rápido das condições atuais no aplicativo ao ser lançado pela primeira vez.
- interruptor Usado para representar um interruptor que pode ser ligado e desligado.
- aba Usado para representar uma aba.
- tablist Usado para representar uma lista de abas.
- texto Usado quando o elemento deve ser tratado como texto estático que não pode mudar.
- timer Usado para representar um temporizador.
- togglebutton Usado para representar um botão de alternância. Deve ser usado com accessibilityState marcado para indicar se o botão está ativado ou desativado.
- barra de ferramentas Usado para representar uma barra de ferramentas (um contêiner de botões de ação ou componentes).
- grade Usado com ScrollView, VirtualizedList, FlatList ou SectionList para representar uma grade. Adiciona os anúncios de entrada/saída de grade no GridView do Android.
Por que Isso Importa
Elementos designados com valores de papel inválidos não são interpretados pela tecnologia assistiva conforme pretendido pelo desenvolvedor.
Quando leitores de tela e outras tecnologias assistivas não sabem o papel de cada elemento, eles não conseguem interagir com ele de forma inteligente, nem conseguem comunicar o papel ao usuário. As características de um elemento, suas propriedades e métodos de transmissão de informações para e/ou do usuário não podem ser comunicados via tecnologias assistivas quando um valor de papel é inválido.
Como Corrigir o Problema
Certifique-se de que o accessibilityRole valor seja um papel válido.
Exemplos de Sucesso
<TouchableOpacity accessibilityRole="button">
<Text>Increase Count</Text>
</TouchableOpacity>Exemplos de Falha
<TouchableOpacity accessibilityRole="secondary-button">
<Text>Increase Count</Text>
</TouchableOpacity>