Documentação
Normas, ferramentas, legislação e guias para entender acessibilidade digital e como interpretar os resultados do InclusivAudit.
Como interpretar os resultados
Entenda o que cada seção do relatório significa e quais ações tomar.
Índice diagnóstico
Não normativoNúmero de 0 a 100 que reflete a gravidade das violações encontradas. É um indicador auxiliar — não representa conformidade formal. Uma pontuação de 100 não garante conformidade WCAG.
Erros (confiança alta)
PrioridadeViolações detectadas automaticamente com alta certeza. Exemplos: imagem sem alt, botão sem nome acessível, link genérico "clique aqui". Corrigir esses é prioridade.
Revisar manualmente
Análise humanaItens detectados com confiança média ou baixa — a ferramenta encontrou um padrão suspeito, mas a confirmação requer julgamento humano. Ex: alt text que pode estar incorreto.
Aceito
VerificadoCritérios verificados e sem violações detectadas. Significa que a regra foi verificada e nenhum problema foi encontrado — não significa que toda a página está correta.
eMAG 3.1
O Modelo de Acessibilidade em Governo Eletrônico é obrigatório para portais da administração pública federal.
eMAG 3.1 — Documento oficial
OficialDocumento completo com todas as recomendações de acessibilidade para governo eletrônico.
AcessarCartilha Técnica do eMAG
TutorialVersão mais didática do eMAG com exemplos práticos de implementação das recomendações.
AcessarDaSilva — Avaliador eMAG
FerramentaFerramenta gratuita de avaliação automática de conformidade com o eMAG, desenvolvida pela gov.br.
Acessar6 categorias de recomendações eMAG 3.1
WCAG 2.1 e 2.2
Web Content Accessibility Guidelines — diretrizes do W3C adotadas globalmente e referenciadas pelo eMAG.
WCAG 2.1 — Especificação
W3CDocumento técnico completo com todos os critérios de sucesso nos níveis A, AA e AAA.
AcessarWCAG 2.2 — Última versão
W3C 2023Versão mais recente do WCAG, publicada em 2023, com 9 novos critérios de sucesso.
AcessarComo entender o WCAG
GuiaGuia W3C com explicações detalhadas, casos de uso e técnicas para cada critério de sucesso.
AcessarWCAG em português (W3C Brazil)
PT-BRTradução não-oficial do WCAG 2.1 em português brasileiro, mantida pela comunidade W3C.
AcessarTutorials WAI
TutorialTutoriais práticos do W3C WAI com exemplos de código para imagens, formulários, tabelas, menus e mais.
AcessarARIA Authoring Practices
ARIAGuia oficial para uso de WAI-ARIA — quando e como usar roles, states e properties corretamente.
Acessar4 princípios WCAG (POUR)
Informação e interface devem ser apresentadas de forma que os usuários possam perceber.
Componentes de interface e navegação devem ser operáveis por qualquer usuário.
Informação e operação da interface devem ser compreensíveis.
Conteúdo deve ser robusto o suficiente para ser interpretado por diferentes agentes de usuário.
Ferramentas complementares
Use em conjunto com o InclusivAudit para uma cobertura mais ampla.
axe DevTools — Deque
Browser extExtensão de browser líder de mercado para análise de acessibilidade. Mesma engine que usamos na análise dinâmica.
AcessarWAVE — WebAIM
Online + extVisualizador de acessibilidade que destaca erros diretamente na página, incluindo contraste e estrutura de cabeçalhos.
AcessarAMAWeb — gov.pt
Governo PTMonitor de Acessibilidade do governo português, baseado no QualWeb. Implementa ACT Rules W3C formais.
AcessarNVDA — Leitor de tela
WindowsLeitor de tela gratuito para Windows. Indispensável para testar a experiência real de usuários cegos.
AcessarColour Contrast Analyser
DesktopFerramenta desktop para verificar contraste de cores entre texto e fundo — indispensável para WCAG 1.4.3.
AcessarLighthouse — Google
DevToolsFerramenta de auditoria integrada ao Chrome DevTools com categorias de performance, SEO e acessibilidade.
AcessarMarco legal da acessibilidade digital
Principais instrumentos normativos que regulam a acessibilidade digital no Brasil.
Lei nº 13.146/2015 — Lei Brasileira de Inclusão
Lei federalPrincipal marco legal da acessibilidade no Brasil. Capítulo II, Seção II trata especificamente de tecnologia assistiva e acessibilidade digital.
AcessarDecreto nº 5.296/2004
DecretoRegulamenta as normas gerais e critérios básicos para promoção da acessibilidade. Art. 47 trata de portais e sítios eletrônicos.
AcessarPortaria SLTI nº 3/2007
PortariaInstitucionaliza o eMAG como padrão obrigatório para portais e sítios da administração pública federal brasileira.
AcessarNBR 17060:2022
ABNTNorma ABNT para acessibilidade na web, alinhada com WCAG 2.1. Referência técnica para organismos públicos e privados.
AcessarComo nosso sistema funciona
Arquitetura técnica e metodologia de análise.
Motor de análise estática (HTML)
O pacote @inclusivaudit/engine faz parse do HTML usando node-html-parser e executa 22 regras de verificação. Rápido (~1s), funciona sem JavaScript. Detecta problemas estruturais como alt faltando, labels desassociados, hierarquia de cabeçalhos incorreta.
Motor de análise dinâmica (Playwright + axe-core)
Quando o modo dinâmico é ativado, o capture-server executa Playwright (Chromium headless) para renderizar a página com JavaScript completo. Em seguida, o axe-core da Deque Systems executa análise in-browser e detecta violações que só existem após a renderização do DOM.
Fusão e deduplicação de resultados
Os findings dos dois motores são mesclados. Violações do axe-core têm precedência para o mesmo critério/seletor — evitando duplicatas. O resultado final é ordenado por severidade (crítico → sério → moderado → menor).
Pontuação (índice diagnóstico)
Score de 0 a 100 calculado com pesos por severidade: crítico (-15), sério (-8), moderado (-4), menor (-1). Serve apenas como indicador relativo — não representa conformidade formal com WCAG ou eMAG.
O que esta ferramenta NÃO verifica
Contraste de cores (requer CSS computado completo), alternativas para vídeo/áudio, navegação por teclado no DOM renderizado, comportamento com tecnologias assistivas reais (NVDA, JAWS), e a maioria dos critérios AAA. Uma auditoria formal é sempre necessária.