Documentação
Normas, ferramentas, legislação e guias para entender acessibilidade digital e como interpretar os resultados do Web para Todos.
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.
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 Web para Todos 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.