Avançar para o conteúdo
SilktideAjuda

Função ARIA inválida

O Silktide verifica todos os atributos role das suas páginas em relação à lista de funções definidas pela norma ARIA. Uma função escrita incorretamente, inventada, vazia ou reservada para uso interno é silenciosamente ignorada pelos navegadores, fazendo com que o significado pretendido do elemento nunca chegue às pessoas que dependem dele.

<!-- Problema: "buton" não é uma função real, por isso esta div continua sem significado -->
<div role="buton" tabindex="0">Save</div>

<!-- Correção: use uma função válida (ou, melhor ainda, um elemento button real) -->
<button>Save</button>

Por que isso é importante

Uma função informa à o que é um elemento — um botão, uma aba ou uma caixa de diálogo. Quando a função é inválida, os navegadores a descartam: uma pessoa que usa um ouve texto simples onde o autor pretendia disponibilizar um controlo e pode não ter como saber que é possível interagir com o elemento. Como a página parece e funciona normalmente para pessoas que usam o rato e conseguem ver, esses erros passam despercebidos sem testes.

Como corrigir

  1. Corrija os erros de digitação para que a função corresponda a uma função ARIA real (lista completa) — por exemplo, role="navigation", e não role="nav".
  2. Substitua funções abstratas (widget, composite, landmark, section e semelhantes) por uma função concreta — as funções abstratas existem apenas para organizar a norma e não devem ser usadas nas páginas.
  3. Remova os atributos vazios role="".
  4. Quando um elemento nativo tiver o significado correto (<button>, <nav>, <main>), prefira-o e remova totalmente o atributo role.

Como o Silktide faz esta verificação

  1. Encontra todos os elementos da página que têm um atributo role.
  2. Comunica valores vazios de role.
  3. Verifica cada palavra do valor de role em relação às funções definidas pela ARIA 1.2. As funções das extensões de publicação digital (doc-) e de gráficos (graphics-) são aceites.
  4. Comunica as palavras que não correspondem a nenhuma função definida e as palavras que designam uma função abstrata.

Resolução de problemas

A função tem várias palavras

Um atributo role pode listar várias funções como alternativas; os navegadores usam a primeira que reconhecem. O Silktide comunica todas as palavras inválidas ou abstratas da lista, para que também possa limpar as alternativas.

Esta verificação não comunica nada, embora eu espere resultados

Os testes de ARIA podem ser desativados por website. Consulte as definições avançadas do website.

Saiba mais

Última atualização

Esta página foi útil?

Função ARIA inválida | Ajuda da Silktide