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
| Fonte | O que traz |
|---|---|
| @govbr-ds/core | Valores exatos da V3: cores, espaçamentos, ícones, componentes |
| gov.br/ds | Regras de uso, anatomia, comportamento e acessibilidade (V3) |
| next-ds | A V4, em prévia |
| eMAG | Recomendaçõ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á.
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ção | Significa |
|---|---|
| igual | Mesmo nome e mesmo valor nas duas versões |
| renomeado | Mesmo papel, nome diferente |
| valor diferente | Mesmo nome, valor diferente |
| aproximado | Sem par exato: ligado ao valor mais próximo da V4, com a diferença indicada |
| substituído | A V4 troca por outra coisa |
| relacionado | O assunto é tratado de outro jeito na V4 |
| só V3 | Existe apenas na V3 |
| só V4 | Existe 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.