Pular para o conteúdo principal

Regras da varredura gov.br

A varredura ajuda você a encontrar, nas telas do Figma, pontos que merecem atenção em relação ao DS gov.br e à acessibilidade. Cada problema vem com a regra, o porquê e a referência. Quando a correção é segura, o plugin corrige; quando não é, sugere um caminho ou pede uma justificativa.

A varredura é um apoio à revisão. Ela não substitui a avaliação de uma pessoa nem os testes com quem usa o serviço, e não atesta a acessibilidade ou a adequação legal do projeto.

Cor fora da paleta do DS​

Regra: Toda cor sólida deve ser um token da paleta do DS gov.br.

Por quê: Esta cor não é um token da paleta do DS gov.br (V3). Cor fora da paleta quebra a identidade visual comum aos serviços do governo e não vem com contraste conferido: a paleta do DS foi escolhida para cumprir o nível AA (4,5:1 para texto normal e 3:1 para texto grande). Fora dela, o contraste precisa ser medido à mão.

Correção: O plugin corrige (com antes e depois; dá para desfazer). Troca a cor pelo token da paleta mais próximo. Só cor, o resto do elemento não muda. Confira o contraste depois: um token vizinho pode mudar a relação entre texto e fundo.

Texto com contraste abaixo do mínimo​

Regra: Texto e fundo têm razão de contraste de pelo menos 4,5:1 (3:1 no texto grande: 24 px, ou 18,66 px em negrito).

Por quê: Com pouco contraste, quem tem baixa visão, daltonismo ou lê o celular sob o sol não consegue ler o texto. A razão é calculada pela fórmula da WCAG sobre o fundo real: as camadas que estão sob o texto, compostas com a opacidade de cada uma.

Correção: Troca a cor do texto por outro grau da mesma família da paleta, que você escolhe entre os que passam. Muda só a cor do texto; a razão é conferida de novo no canvas depois da troca.

Contraste para conferir à mão​

Regra: Texto sobre imagem, gradiente ou efeito também precisa de 4,5:1 (3:1 no texto grande) em todos os pontos do fundo.

Por quê: Sob este texto há algo que não tem uma cor só (imagem, gradiente, desfoque ou uma camada que cobre só parte dele), então a varredura não calcula a razão. O item não reprova: pede que você confira. O eMAG recomenda não usar imagem atrás do texto.

Correção: Correção feita por você no Figma; o plugin explica o que fazer. Sem correção automática. Meça o contraste no ponto mais claro e no mais escuro do fundo. Se passar, justifique dizendo como conferiu; se não, ponha uma camada sólida sob o texto e varra de novo.

  • eMAG 3.1 · Recomendação 4.1 (Oferecer contraste mínimo entre plano de fundo e primeiro plano) · WCAG 2.1, critério 1.4.3 Contraste (mínimo), nível AA

Texto fora da Rawline​

Regra: O texto das telas usa a família Rawline, a única do DS gov.br.

Por quê: O DS gov.br usa uma só família tipográfica, a Rawline: ela identifica os produtos do Governo Federal e a variedade de pesos dispensa outra fonte. A varredura do CoboGov dá o Padrão Mínimo por atendido quando ao menos 80% dos textos estão em Rawline.

Correção: O plugin corrige (com antes e depois; dá para desfazer). Troca a família para Rawline mantendo o peso (estilo). Exige a Rawline instalada com esse peso. A largura do texto pode mudar e mexer no layout.

Raio fora da escala​

Regra: O arredondamento dos cantos usa os tokens de raio do DS gov.br.

Por quê: O arredondamento dos cantos no DS gov.br vem de tokens fixos. Um valor fora da escala não existe em nenhum token e vira exceção de CSS na implementação, além de fazer o mesmo tipo de elemento parecer diferente de uma tela para outra.

Correção: O plugin corrige (com antes e depois; dá para desfazer). Arredonda o raio para o valor mais próximo da escala.

Espaçamento fora da escala​

Regra: Espaçamento interno e entre itens em múltiplos de 4 px (escalas de 8 px e de 4 px do DS).

Por quê: O DS gov.br define duas escalas de espaçamento (Layout, em passos de 8 px, e Ajuste, em passos de 4 px) para manter o ritmo da tela e para designer e desenvolvedor falarem os mesmos valores. Um valor fora delas não corresponde a token e gera CSS avulso.

Correção: O plugin corrige (com antes e depois; dá para desfazer). Arredonda para o múltiplo de 4 px mais próximo. Mexe no tamanho do contêiner quando ele cresce com o conteúdo.

Área de toque menor que 24 × 24 px​

Regra: Todo elemento interativo tem área de toque de pelo menos 24 × 24 px.

Por quê: Alvo pequeno é difícil de acertar para quem tem tremor, pouca coordenação motora ou usa o celular com uma mão. A WCAG 2.2 pede pelo menos 24 × 24 px. Exceções: alvo menor com espaço livre em volta (um círculo de 24 px centrado nele não toca outro alvo) e link dentro de uma frase; nesses casos, justifique.

Correção: Correção feita por você no Figma; o plugin explica o que fazer. Sem correção automática: mudar o tamanho mexe no layout. Aumente o elemento, ou a área clicável em volta dele, no Figma e varra de novo; ou justifique.

  • WCAG 2.2, critério 2.5.8 Tamanho mínimo do alvo, nível AA (citado pelo DS gov.br V4 na acessibilidade dos componentes)
  • DS gov.br V3 · Padrões › Densidade (área mínima de ação: 24 px com mouse, 40 px com toque)
  • DS gov.br V4 · Fundamentos › Estado (tokens br.state.target.minimum = 24 e br.state.target.enhanced = 44)

Área de toque abaixo da recomendada para app​

Regra: Em tela de aplicativo, a área de toque recomendada é de 44 × 44 px.

Por quê: No celular o dedo cobre mais área que o cursor e erra mais. O DS gov.br V4 traz a área ideal no token br.state.target.enhanced (44 px) e o V3 pede 40 px para toque. É recomendação: não reprova a varredura nem tira nota do Prumo.

Correção: Correção feita por você no Figma; o plugin explica o que fazer. Sem correção automática: mudar o tamanho mexe no layout. Aumente o elemento no Figma e varra de novo, ou registre por que o tamanho atual atende.

  • DS gov.br V4 · Fundamentos › Estado (tokens br.state.target.minimum = 24 e br.state.target.enhanced = 44)
  • DS gov.br V3 · Padrões › Densidade (área mínima de ação: 24 px com mouse, 40 px com toque)

Camada com nome automático​

Regra: Camadas importantes têm nome que diz o que são.

Por quê: Um nome como "Frame 12" não diz o que a camada é. Quem implementa e quem revisa a acessibilidade (rótulos, ordem de leitura) precisa identificar cada elemento; nome significativo também sustenta a documentação e a busca no arquivo.

Correção: O plugin aplica o valor que você informar. Renomeia a camada com o nome que você digitar (não pode repetir o nome automático do Figma).

  • Prática de organização do arquivo e de handoff. Não é critério WCAG nem regra do DS gov.br.

Tela sem conexão de protótipo​

Regra: Cada tela do fluxo está ligada a outra no protótipo.

Por quê: Uma tela sem nenhuma conexão não pode ser percorrida nem testada com pessoas: o teste de usabilidade e a revisão do fluxo dependem de um caminho navegável. Se a tela é só de consulta, apoio ou estado isolado, justifique.

Correção: Correção feita por você no Figma; o plugin explica o que fazer. Não há correção automática: as conexões dependem de decisão de fluxo. Ligue a tela no modo Protótipo do Figma (ou use o Desenho de fluxo para documentar) e varra de novo.

  • Prática de organização do arquivo e de handoff. Não é critério WCAG nem regra do DS gov.br.

Cabeçalho do DS não encontrado​

Regra: As telas usam o cabeçalho (header) do DS gov.br.

Por quê: O cabeçalho é um dos pontos de aderência mínima ao Padrão Digital de Governo: ele leva a identidade e a navegação comuns dos serviços do governo. Nenhuma instância do componente Header do DS foi encontrada nas telas varridas.

Correção: Correção feita por você no Figma; o plugin explica o que fazer. Não é automática: o componente vem da biblioteca do DS e precisa ser instanciado na tela. Se o produto não usa cabeçalho (ex.: tela embutida em outro sistema), justifique.

  • DS gov.br · Componente Header
  • DS gov.br · Introdução › Padrão Mínimo (pontos de aderência mínima: cabeçalho, logo gov.br, rodapé, Rawline, paleta, botões)

Rodapé do DS não encontrado​

Regra: As telas usam o rodapé (footer) do DS gov.br.

Por quê: O rodapé é outro ponto de aderência mínima ao Padrão Digital de Governo. Nenhuma instância do componente Footer do DS foi encontrada nas telas varridas.

Correção: Correção feita por você no Figma; o plugin explica o que fazer. Não é automática: o componente vem da biblioteca do DS e precisa ser instanciado na tela. Se o produto não usa rodapé, justifique.

  • DS gov.br · Componente Footer
  • DS gov.br · Introdução › Padrão Mínimo (pontos de aderência mínima: cabeçalho, logo gov.br, rodapé, Rawline, paleta, botões)

Menos de 80% dos textos em Rawline​

Regra: Ao menos 80% dos textos das telas estão em Rawline.

Por quê: A tipografia Rawline é ponto de aderência mínima do DS gov.br. A varredura do CoboGov considera o ponto atendido quando ao menos 80% dos textos estão em Rawline.

Correção: Correção feita por você no Figma; o plugin explica o que fazer. Corrija os textos fora da Rawline um a um (itens do grupo Fonte): quando passar de 80%, este item deixa de aparecer na próxima varredura.

Botões do DS não encontrados​

Regra: Os botões das telas são instâncias do componente Button do DS gov.br.

Por quê: Os botões são ponto de aderência mínima ao Padrão Digital de Governo. Nenhuma instância do componente Button do DS foi encontrada nas telas varridas.

Correção: Correção feita por você no Figma; o plugin explica o que fazer. Não é automática: troque os botões desenhados à mão por instâncias do Button da biblioteca. Se a tela não tem ação, justifique.

  • DS gov.br · Componente Button
  • DS gov.br · Introdução › Padrão Mínimo (pontos de aderência mínima: cabeçalho, logo gov.br, rodapé, Rawline, paleta, botões)

Nenhum componente do DS nas telas​

Regra: As telas são montadas com componentes do DS gov.br.

Por quê: Nenhuma instância de componente do DS gov.br foi encontrada nas telas varridas. Sem os componentes da biblioteca, o desenho não herda estados, comportamento e acessibilidade já validados pelo DS.

Correção: Correção feita por você no Figma; o plugin explica o que fazer. Não é automática: instancie os componentes da biblioteca do DS no lugar do desenho avulso. Se o projeto ainda está em fase conceitual, justifique.

Comentários e evolução

Viu algo a corrigir ou completar nesta especificação? Comente abaixo dizendo qual parte, o que mudar e a fonte (WCAG, eMAG, WAI-ARIA APG, documentação do DS gov.br ou teste com leitor de tela). É preciso uma conta no GitHub. As sugestões aceitas entram na base e aparecem nas Novidades.