Digite para filtrar as páginas da documentação.

    Specsfy

    Especialista Acessibilidade Web no Specsfy: guia técnico

    Consulte o guia da especialista Acessibilidade Web no Specsfy, com quando usar, fluxo, padrões, antipadrões e validação técnica para o seu projeto.

    Quando usar

    • Acionar ao implementar ou auditar páginas, componentes, formulários, dashboards, mídia e fluxos críticos contra WCAG e semântica da plataforma.
    • Acionar para bugs de teclado, foco, nome acessível, contraste, zoom, reflow, leitor de tela ou outras tecnologias assistivas.
    • Não acionar apenas para preferência visual sem barreira observável, usar $specsfy-specialist-ui-design.
    • Combinar com a skill do framework para corrigir o código sem transferir a responsabilidade de conformidade ao framework.

    Fluxo

    1. Descobrir política, nível WCAG, navegadores, tecnologias assistivas, público e fluxos críticos, separar auditoria de conformidade de teste de usabilidade.
    2. Inventariar barreiras por estrutura, percepção, teclado, foco, formulário, atualização dinâmica, mídia e autenticação usando references/standards.md.
    3. Corrigir HTML e comportamento nativos antes de adicionar ARIA ou widget customizado, verificar nome, papel, valor, estado e relações calculados.
    4. Implementar teclado, ordem lógica, foco visível, foco não encoberto e gestão após abertura, fechamento, navegação e atualização assíncrona.
    5. Validar contraste, zoom, reflow, espaçamento de texto, target size, forced colors, orientação, movimento e alternativas de mídia.
    6. Executar análise automática e inspeção manual, classificar cada achado por critério, impacto, caminho de reprodução e correção verificável.
    7. Exercitar tarefas críticas com tecnologia assistiva representativa e documentar cobertura, limitações, exceções e risco residual.

    Padrões

    • Nenhuma ação depende apenas de hover, cor, gesto ou pointer preciso.
    • Todo controle tem nome, papel, valor e estado corretos.
    • Modal prende foco, fecha por mecanismo previsível e devolve foco.
    • Erros são associados aos campos e resumidos quando necessário.
    • Updates assíncronos anunciam somente informação relevante.
    • Charts oferecem texto/tabela equivalente e não dependem de cor.
    • ARIA nunca corrige semântica nativa incorreta.

    Antipadrões

    • Declarar conformidade porque axe ou um linter zerou, automação não confirma ordem de foco, linguagem, alternativas equivalentes ou fluxo completo.
    • Aplicar role, tabindex e handlers a div quando um elemento nativo cobre o contrato, recria parcialmente teclado e semântica do browser.
    • Usar aria-label para substituir texto visível sem necessidade, nomes divergentes quebram reconhecimento por voz e manutenção.
    • Mover foco em toda atualização assíncrona, interrompe leitura e contexto. Anuncie status proporcional e mova foco somente quando a tarefa exigir.
    • Ocultar overflow para “resolver” reflow, o conteúdo continua inacessível, apenas deixa de ser alcançável visualmente.

    Validação

    • Executar fluxo completo por teclado, sem armadilha, perda ou foco encoberto, conferir ordem e retorno de foco em overlays.
    • Verificar resize de texto a 200% e reflow equivalente a 320 CSS px para conteúdo vertical, além de spacing de texto e orientação suportada.
    • Medir contraste de texto, componentes e indicadores de foco e testar forced colors e reduced motion quando aplicáveis.
    • Combinar axe/linter com inspeção do accessibility tree e leitor de tela nos fluxos de maior risco.
    • Não declarar conformidade WCAG sem mapear critérios, escopo, evidência, limitações e exceções, “acessível” não é sinônimo de teste automatizado verde.

    Skills relacionadas

    • $specsfy-specialist-react-ui-components e $specsfy-specialist-shadcn-ui fornecem componentes que esta skill audita por semântica, foco, teclado e nome acessível.
    • $specsfy-specialist-tailwind-css implementa contraste, forced colors, reflow e reduced motion nos utilitários e tokens observados.
    • $specsfy-specialist-ui-design governa hierarquia, tokens e estados visuais que precisam satisfazer contraste, reflow e foco.
    • $specsfy-specialist-ux-design pesquisa compreensão e sucesso de tarefa, inclusive com pessoas que usam tecnologias assistivas.
    • $specsfy-specialist-react e $specsfy-specialist-astro ou $specsfy-specialist-nextjs implementam a correção no framework observado.
    • $specsfy-specialist-code-review amplia a revisão para riscos além do recorte de acessibilidade.

    Leia references/standards.md para critérios WCAG 2.2, contratos de componentes, formulários, conteúdo dinâmico e matriz de testes.

    Planos Promovaweb

    Tire seus projetos do papel

    O Plano Martech cobre automação e atendimento. O Plano IA Makers acrescenta desenvolvimento com IA, enquanto o Plano Founders trata de gestão de negócios. Todos são anuais.

    Plano Martech

    Para conectar automação, marketing e atendimento com infraestrutura própria.

    R$ 897

    R$ 597/ano

    • Grade de automação, atendimento, marketing e análise de indicadores
    • Instalador Exclusivo Promovaweb
    • n8n, Evolution API, Chatwoot e Mautic
    • Trilha DevOps incluída
    • Encontros ao vivo (terça e quinta)
    • Comunidade e acompanhamento
    Conhecer o plano

    Plano Founders

    Plano anual para fazer um projeto de tecnologia avançar, com 90 dias de mentoria intensiva.

    R$ 2.997/ano

    • 12 meses de acesso ao Founders
    • 90 dias de mentoria intensiva (segunda a sexta)
    • War Rooms às segundas, quartas e sextas
    • Encontro semanal em grupo após a fase intensiva
    • Formação Vibe Coding incluída no plano anual
    • Consultoria individual de até duas horas (bônus)
    Conhecer o plano