Pular para o conteúdo principal

Base do DS gov.br (V3 e V4)

O CoboGov mostra medidas, tokens, componentes e regras do Padrão Digital de Governo (DS gov.br). Esta página explica de onde vem cada informação, como você confere e com que frequência a base é atualizada.

Você vê esses dados na Inspeção, nas fichas e no Sobre. Assim, o que o CoboGov mostra pode ser conferido na fonte.

A regra principal: o conhecimento do DS vai dentro do plugin. O plugin não consulta o site do DS enquanto você trabalha.

Fontes​

FonteO que traz
@govbr-ds/coreValores exatos da V3: cores, espaçamentos, ícones, componentes
gov.br/dsRegras de uso, anatomia, comportamento e acessibilidade (V3)
next-dsA V4, em prévia
eMAGRecomendações de acessibilidade do governo federal (versão 3.1)

A versão e a data de coleta de cada fonte aparecem em Sobre › Fontes do DS gov.br e no rodapé das fichas.

Quando duas fontes divergem, vale esta ordem: valores exatos do @govbr-ds/core; regras de uso do gov.br/ds; next-ds só quando o projeto mira a V4 ou para o que só existe lá.

A V3 e a V4 não se misturam

O CoboGov usa a V3 como padrão. A V4 pode ser escolhida em Dados do projeto; a varredura confere contra a V3. A V4 está em prévia no DS gov.br e pode mudar.

Correspondência entre V3 e V4​

Para cada item da V3, o CoboGov mostra o que existe na V4. Cada par recebe uma situação:

SituaçãoSignifica
igualMesmo nome e mesmo valor nas duas versões
renomeadoMesmo papel, nome diferente
valor diferenteMesmo nome, valor diferente
aproximadoSem par exato: ligado ao valor mais próximo da V4, com a diferença indicada
substituídoA V4 troca por outra coisa
relacionadoO assunto é tratado de outro jeito na V4
só V3Existe apenas na V3
só V4Existe apenas na V4

Componentes, cores, espaçamentos, superfície, tipografia e ícones são casados por nome e valor. Fundamentos e padrões (o que é "substituído" ou "relacionado") dependem de curadoria humana, porque não dá para decidir isso só por cálculo. Se você precisa de certeza para uma decisão, confira na fonte oficial.

Exemplo que você pode conferir​

A cor primária do DS, blue-warm-vivid-70, é #1351b4 na V3 e #0040b4 na V4. A situação é "valor diferente". Se você montar uma tela com a V3 e depois migrar para a V4, esse azul muda.

Onde você vê a procedência​

  • Cartões da Inspeção. Cada linha de cor, espaçamento, raio e componente diz o token da V3 e o par da V4 com a situação. O rodapé do cartão diz de qual base veio.
  • Fichas de documentação das telas. O rodapé traz a linha "Base do DS", com a versão, o commit e as datas de coleta. A tabela tem a coluna "Fonte e V4".
  • Aviso de ficha antiga. Se a fonte oficial mudou depois que você gerou uma ficha, o CoboGov avisa e sugere atualizar a ficha.
  • Sobre › Fontes do DS gov.br. Lista as fontes com link e data de coleta, e resume quantos componentes não existem na V4 e quantos tokens mudam de valor.
  • Conferir novidades (no mesmo lugar). Verifica qual é a versão mais recente do pacote do DS e compara com a da base do plugin.

O que "Conferir novidades" envia​

Só o nome do pacote do DS vai na consulta. Nada do seu projeto e nada sobre você. A consulta só acontece quando você clica no botão. Se houver versão nova, o plugin avisa. O plugin não troca a base sozinho: a base nova chega, depois de revisada, com a atualização do CoboGov.

Com que frequência a base é atualizada​

A base é conferida regularmente contra as fontes públicas acima. Quando alguma fonte muda, uma pessoa da CriAugu revisa a mudança antes de ela entrar no plugin.

Como isso chega ao CoboGov​

Depois de revisada, a base nova sai numa nova versão do plugin. Depois disso, o Sobre passa a mostrar as datas novas e as fichas antigas mostram o aviso de base desatualizada.

Veja também Integrações.