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.
- DS gov.br · Fundamentos visuais › Cores
- 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 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.
- 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
- DS gov.br · Fundamentos visuais › Cores
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.
- DS gov.br · Fundamentos visuais › Tipografia (Rawline)
- 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)
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.
- DS gov.br · Fundamentos visuais › Tipografia (Rawline)
- 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)
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.