ID de aria-controls em falta
O Silktide verifica todos os atributos aria-controls nas suas páginas e confirma que os IDs dos elementos indicados existem realmente. Este atributo declara sobre que parte da página um controlo atua, como o painel que um separador mostra ou o menu que um botão abre.
<!-- Problema: nenhum elemento na página tem id="filter-panel" -->
<button aria-expanded="false" aria-controls="filter-panel">Filtros</button>
Porque é importante
O atributo aria-controls da permite que as
associem um
controlo ao conteúdo que este afeta — alguns
disponibilizam um atalho para ir
diretamente para o elemento controlado. Quando a referência está incorreta, essa
relação desaparece silenciosamente. Normalmente, referências incorretas significam que um ID foi
renomeado ou que um componente foi removido, pelo que também constituem um aviso antecipado de que
o próprio widget pode deixar de funcionar como previsto.
Como corrigir
- Faça corresponder cada ID indicado em
aria-controlsaoidde um elemento real na mesma página. O atributo pode indicar vários IDs separados por espaços; verifique cada um. - Se o elemento controlado for adicionado dinamicamente, apresente-o oculto
desde o início ou defina
aria-controlsquando este existir. - Se o elemento controlado tiver sido removido definitivamente, remova o atributo.
Como o Silktide testa isto
- Localize todos os elementos da página com um atributo
aria-controls. - Verifique cada ID referenciado em relação aos IDs dos elementos presentes na página.
- Comunique cada referência que não corresponde a nenhum elemento.
Resolução de problemas
O destino é criado mais tarde por um script
O Silktide testa a página à medida que esta é carregada. Se o painel referenciado só aparecer após a interação do utilizador, a referência estará incorreta até esse momento — prefira manter o destino na página (oculto), para que a referência seja sempre resolvida.