Auditor de Acessibilidade HTML

A maioria das verificações rápidas de acessibilidade ou é uma análise superficial de palavras-chave ou uma biblioteca pesada em que tem de confiar como uma caixa negra. Esta ferramenta segue um terceiro caminho: analisa o HTML que colar usando o DOMParser nativo do próprio browser — sem axe-core, sem bibliotecas de acessibilidade externas, nada é descarregado — e depois percorre a árvore DOM resultante com um conjunto de verificações escritas à mão que espelham padrões de falha WCAG 2.1 comuns e reais. Isto significa que a lógica é totalmente inspecionável e a auditoria decorre inteiramente dentro do seu browser: o markup que colar e qualquer par de cores que testar nunca são enviados para lado nenhum.

As verificações cobrem as falhas que aparecem com mais frequência em páginas reais: elementos <img> sem qualquer atributo alt (uma falha WCAG genuína, distinta do alt="" deliberadamente vazio usado para imagens decorativas, que é corretamente ignorado), controlos de formulário sem forma de as tecnologias de apoio saberem para que servem (verificado em relação a todos os caminhos reais para um label — um <label for> correspondente, estar envolvido por um <label> ou um atributo aria-label/aria-labelledby), níveis de cabeçalho que saltam sem aviso (um <h1> diretamente para um <h3>, ou um documento sem qualquer <h1>, ou mais do que um), links sem href ou com texto vago e descontextualizado como "clique aqui" ou "saiba mais", e a ausência do atributo lang quando é colado um documento HTML completo (e não apenas um fragmento).

O ponto forte é a matemática de contraste genuína, não uma heurística superficial do tipo "parece legível". Para qualquer elemento que tenha estilos inline color e background-color, a ferramenta lê ambos os valores, converte-os em números RGB reais através do motor de CSS do próprio browser (para que hex, rgb(), hsl() e cores por nome como 'tomato' funcionem todos de forma idêntica) e calcula a luminância relativa WCAG exata para cada um — L = 0,2126×R + 0,7152×G + 0,0722×B, com cada canal previamente corrigido pela curva de transferência sRGB real — antes de os combinar na fórmula oficial do rácio de contraste, (L mais claro + 0,05) / (L mais escuro + 0,05). O font-size e o font-weight do próprio elemento determinam se se aplicam os limiares mais rigorosos de "texto normal" ou os mais permissivos de "texto grande" (18pt+ ou 14pt+ negrito), e o resultado é confrontado com os quatro valores WCAG reais de uma só vez: 4,5:1 e 3:1 para AA, 7:1 e 4,5:1 para AAA — nunca colapsado num único veredito falso de bom/mau.

Trata-se de um subconjunto deliberadamente honesto e pragmático de uma auditoria de acessibilidade completa, não de uma ferramenta de certificação: não avalia interatividade baseada em JavaScript, padrões de widgets ARIA para além da etiquetagem básica, ordem de foco do teclado, nem nada que exija renderizar e executar a página. Encare-a como uma primeira passagem rápida que deteta algumas das falhas WCAG mais comuns e com mais consequências — falta de texto alternativo, campos sem label, hierarquia de cabeçalhos quebrada, texto de baixo contraste e links vagos — antes da publicação de uma página, como complemento (e não substituto) de uma revisão manual completa ou de uma ferramenta de auditoria dedicada para tudo o que for para produção.