ID de aria-controls ausente

A Silktide executa uma verificação em cada atributo aria-controls das suas páginas e confirma se os IDs dos elementos listados realmente existem. Esse atributo declara qual parte da página um controle opera, como o painel exibido por uma aba ou o menu aberto por um botão.

<!-- Problema: nenhum elemento na página tem id="filter-panel" -->
<button aria-expanded="false" aria-controls="filter-panel">Filtros</button>

Por que isso é importante

O atributo aria-controls da permite que a associe um controle ao conteúdo que ele afeta — alguns oferecem um atalho para ir diretamente ao elemento controlado. Quando a referência está quebrada, essa relação desaparece silenciosamente. Referências quebradas geralmente significam que um ID foi renomeado ou que um componente foi removido; por isso, elas também são um alerta precoce de que o próprio widget pode não estar mais funcionando como deveria.

Como corrigir

Faça com que cada ID listado em aria-controls corresponda ao id de um elemento real na mesma página. O atributo pode listar vários IDs separados por espaços; verifique cada um deles.
Se o elemento controlado for adicionado dinamicamente, renderize-o oculto desde o início ou defina aria-controls assim que ele existir.
Se o elemento controlado tiver sido removido permanentemente, remova o atributo.

Como a Silktide testa isso

Encontra todos os elementos da página que têm um atributo aria-controls.
Verifica cada ID referenciado em relação aos IDs dos elementos presentes na página.
Relata cada referência que não corresponde a nenhum elemento.

Solução de problemas

O destino é criado posteriormente por um script

A Silktide testa a página enquanto ela é carregada. Se o painel referenciado só aparecer após uma interação do utilizador, a referência estará quebrada até lá — prefira manter o destino na página (oculto) para que a referência seja sempre resolvida.

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

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