Acessibilidade
Esta página tem duas partes. A primeira trata da acessibilidade da própria janela do CoboGov. A segunda mostra como o CoboGov ajuda você a projetar sistemas acessíveis.
Parte 1. A acessibilidade da interface do CoboGov
Nosso compromisso
A janela do CoboGov é projetada para atender à WCAG 2.1 nível AA. O objetivo vale para tudo o que aparece dentro do plugin: cabeçalho, rodapé, modais, painéis e as telas das ferramentas. É uma meta de projeto, não uma certificação: veja as limitações conhecidas mais abaixo.
O que é testado automaticamente
A cada versão, testes automáticos conferem a interface. Eles verificam, entre outros pontos:
- Nome acessível em todo botão. Todo botão tem texto ou
aria-label(WCAG 4.1.2). - Botão só com ícone. O nome diz a ação e o alvo (por exemplo, "Subir Botão na ordem de foco"), e a dica que aparece ao passar o mouse (
title) é igual ao nome (WCAG 2.5.3, 4.1.2). - Nome contém o texto visível. Quando o botão tem texto na tela e um nome acessível, o nome inclui esse texto, para quem controla o computador por voz (WCAG 2.5.3).
- Ícones e imagens. Todo SVG é decorativo (escondido do leitor de tela) ou tem papel de imagem e nome. Toda imagem tem
alt(WCAG 1.1.1). - Campos com rótulo. Todo campo, lista e área de texto tem rótulo associado (WCAG 1.3.1, 3.3.2, 4.1.2). As referências
aria-labelledbyearia-describedbyapontam para elementos que existem. - Estrutura da página. Idioma definido como português do Brasil (WCAG 3.1.1). Um único cabeçalho, uma única região principal e um único rodapé. Todo modal tem papel de diálogo,
aria-modale um título que o nomeia. - Avisos em regiões ao vivo. Avisos de sucesso vão para uma região
status, e erros vão para uma regiãoalert(WCAG 4.1.3). O aviso visível na tela fica escondido do leitor de tela, para não ser lido duas vezes. - Foco em modais. Ao abrir, o foco entra no diálogo. O Tab fica preso dentro dele, e o Shift+Tab também. O Esc fecha, e o foco volta ao botão que abriu (WCAG 2.1.2, 2.4.3). Se o botão que abriu foi redesenhado, o foco vai para o título da tela.
- Foco ao trocar de tela. Ao trocar de tela, o foco vai para o título principal (h1). Isso não acontece ao abrir o plugin, para não tomar o foco de quem acabou de chegar (WCAG 2.4.3, 4.1.3).
- Foco sobrevive ao redesenho. Quando uma tela é redesenhada, o foco do teclado segue o botão pelo nome em vez de se perder (WCAG 2.4.3).
- Títulos em ordem. Cada tela tem exatamente um h1 e nenhum salto de nível, por exemplo de h2 direto para h4 (WCAG 1.3.1, 2.4.6).
- Movimento reduzido. O CSS respeita a preferência "reduzir movimento" do sistema (WCAG 2.3.3). Isso vale, por exemplo, para a animação do símbolo da home.
- Foco visível. Nenhum estilo remove o contorno de foco (WCAG 2.4.7). A única exceção são os títulos que recebem foco por script, que não são controles.
- Contraste calculado nos dois temas. Pares de texto e fundo precisam de pelo menos 4,5:1 (WCAG 1.4.3). Foco, bordas de campo e ícones precisam de pelo menos 3:1 (WCAG 1.4.11). O cálculo usa a luminância relativa e é feito nos temas claro e escuro, inclusive nas cores de cada área (Projeto, Design, Acessibilidade e Gestão).
- Termos em inglês. Os nomes em inglês dos métodos (Benchmarking, Service Blueprint e outros) levam
lang="en", para o leitor de tela pronunciar corretamente (WCAG 3.1.2). - Personalização. Mudar uma opção não fecha o painel, e clicar fora fecha.
Personalização
O botão Personalização, no cabeçalho, abre um painel com ajustes que valem só para você, naquela instalação do plugin. Eles ficam guardados no seu computador, nunca no arquivo do Figma, e o botão "Restaurar padrão" desfaz tudo.
| Ajuste | Opções |
|---|---|
| Interface (escala) | 100%, 115% e 130% |
| Texto | 100%, 125% e 150%. Muda só as letras; os ícones mantêm o tamanho. |
| Tema | Igual ao Figma, Claro ou Escuro |
| Espaçamento de texto | Mais espaço entre linhas, letras e palavras (WCAG 1.4.12) |
| Leitura em voz alta | Lê o que recebe foco ou fica sob o mouse, e os avisos. O Esc interrompe. A velocidade pode ser devagar, normal ou rápida. |
A leitura em voz alta usa a síntese de voz do seu sistema, e nada sai do seu computador. Ela lê o mesmo nome que um leitor de tela leria, mas não substitui um leitor de tela. Se o sistema não oferecer síntese de voz, a opção aparece desligada e avisa que está indisponível. Se não houver voz em português instalada, o plugin usa a voz padrão.
Limitações conhecidas
- Sem teste com leitores de tela reais. A interface do plugin não foi testada no Figma desktop com NVDA, JAWS ou VoiceOver. Os testes automáticos conferem nomes, papéis, rótulos, foco e contraste na marcação, mas não mostram como cada leitor de tela anuncia a interface dentro da janela de plugin do Figma. A acessibilidade da interface é uma meta de projeto verificada por testes automáticos, e não uma certificação.
- Testes automáticos não cobrem tudo. Eles não medem zoom e reflow, tamanho de alvo em pixels, nem a experiência de uso real.
- O que você desenha no canvas é do Figma. As fichas, réplicas e marcações que o CoboGov desenha no canvas são camadas do Figma. A acessibilidade do próprio editor do Figma está fora do controle do CoboGov.
- Voz alta depende do sistema. A qualidade e a disponibilidade da voz variam conforme o sistema operacional e o app onde o Figma roda.
- Sem avaliação externa. A interface não passou por avaliação com pessoas com deficiência.
Como relatar um problema
Se você encontrar uma barreira de acessibilidade no CoboGov, conte para a gente pelos canais informados na tela Sobre do plugin (clique no logo) e em criaugu.com. Para ajudar, diga:
- em qual tela ou ferramenta aconteceu;
- qual tecnologia assistiva ou ajuste você usava (leitor de tela, zoom, voz alta, só teclado);
- o que você esperava e o que aconteceu.
Não envie dados pessoais nem conteúdo sigiloso do seu projeto no relato.
Parte 2. Como o CoboGov ajuda a projetar sistemas acessíveis
O CoboGov leva a acessibilidade do início ao fim do projeto: do registro das necessidades do público até a ficha que o time de desenvolvimento recebe. A base é o eMAG 3.1 (Modelo de Acessibilidade em Governo Eletrônico), que se apoia na WCAG e adota os quatro princípios dela: perceptível, operável, compreensível e robusto. Os componentes do DS gov.br trazem as orientações de acessibilidade próprias. Os critérios citados abaixo são os que o próprio eMAG 3.1 aponta.
As funcionalidades avançadas têm 7 usos de cada no plano Grátis e uso sem limite a partir da Básica. Veja Planos.
Checklist de acessibilidade (eMAG)
É um artefato que você insere no canvas, na etapa de Usabilidade e acessibilidade. Ele organiza a conferência pelos quatro princípios:
- Perceptível: texto alternativo, contraste AA, informação que não depende só de cor, legenda ou transcrição.
- Operável: tudo pelo teclado, foco visível, atalhos para o conteúdo (skip link), ordem de foco igual à de leitura, área de toque (mínimo de 24 px, ideal de 44 px), limite de tempo.
- Compreensível: idioma da página, campos com rótulo e instruções, erros identificados com sugestão de correção, título descritivo em cada tela.
- Robusto: nome, função e valor para leitor de tela, títulos H1 a H6 em hierarquia, regiões da página marcadas.
Cada item tem a fonte indicada. O artefato lê as necessidades de acesso registradas nas Personas, para a conferência partir de quem realmente vai usar o sistema. O resultado alimenta o Design Handoff (pacote de entrega).
Leitor de tela
Etapa da Documentação de acessibilidade. Para cada tela registrada, especifica o que o desenvolvimento precisa saber sobre cada elemento: papel, nome acessível, estados, o que o leitor de tela deve anunciar, teclado e uma nota para o código. Usa a versão do DS gov.br escolhida nos Dados do projeto (V3 ou V4). Elementos idênticos viram um grupo só, com um cartão e um número.
O anúncio vem rotulado como esperado segundo o padrão do W3C (WAI-ARIA APG), porque cada leitor de tela (NVDA, JAWS, VoiceOver, TalkBack) fala de um jeito. Quem testar com um leitor de tela de verdade registra o resultado e qual leitor usou; só assim o elemento conta como testado. A especificação de cada componente está aberta em Especificações › Leitor de tela.
Esta etapa também reúne o que antes era o Roteiro de acessibilidade, organizado pelas recomendações do eMAG 3.1 e pelos princípios da WCAG: título da página, idioma, marcos de página, níveis de título, textos alternativos, ordem de foco e contraste. Cada pendência aparece com uma situação:
- Atenção: conferida automaticamente e com problema.
- Decisão do designer: precisa da sua confirmação.
- Para o código: só dá para verificar na implementação, então fica registrada para o desenvolvimento.
O que o plugin propõe sozinho, como a ordem de foco ou os níveis de título, é sempre uma proposta: você confirma ou ajusta. O contraste dos textos é calculado pela luminância relativa, com o mínimo de 4,5:1 para texto comum e 3:1 para texto grande (eMAG 4.1, WCAG 1.4.3). O plugin desenha os cartões numerados sobre uma cópia de trabalho da tela e gera a ficha por tela, também em PDF e em HTML acessível.
Ordem de foco
Define a ordem em que o teclado percorre a tela e o nome que o leitor de tela anuncia em cada parada. O plugin desenha a ordem numerada sobre uma cópia de trabalho da tela, sem alterar o original. É a recomendação 1.4 do eMAG (ordenar de forma lógica e intuitiva a leitura e a tabulação), ligada ao critério 2.4.3 da WCAG.
Trilha de gestos (só para telas de app)
Em telas de aplicativo, mostra a sequência em que o leitor de tela do celular (TalkBack, VoiceOver) percorre a tela quando a pessoa desliza o dedo. Fica de fora de telas web.
Varredura gov.br
Confere as páginas escolhidas contra o DS gov.br: cabeçalho e rodapé do DS, fonte Rawline, cores da paleta, escalas de espaçamento e raio, componentes do DS, nomes de camada e telas conectadas em protótipo. Ela não substitui a especificação de leitor de tela, mas ajuda a notar cedo o que afeta a acessibilidade, como o uso de componentes do DS, que trazem orientações próprias de acessibilidade.
Documentação e Handoff de acessibilidade
A Documentação de acessibilidade reúne, por tela, as etapas Leitor de tela, Ordem de foco e, em apps, Gestos. O Handoff de acessibilidade produz uma ficha do projeto inteiro para o desenvolvimento: o que cada tela registrada pede e o que ainda falta documentar. A ficha vai para o canvas, pode ser guardada em versões e baixada em HTML: um arquivo único, sem depender de internet, que o desenvolvimento e o teste com leitor de tela abrem no navegador (idioma, marcos, sumário com links, tabelas com cabeçalhos, imagem da tela com texto alternativo, tema claro e escuro e impressão limpa).
Eixo Acessibilidade do Prumo
O Prumo é o painel de maturidade do CoboGov. O eixo Acessibilidade soma estrelas conforme o projeto avança, e cada critério acende sozinho quando a ferramenta correspondente é usada.
| Estrelas | Critério | De onde vem |
|---|---|---|
| 1 | Nível pretendido (A, AA ou AAA) declarado | Dados do projeto |
| 2 | Necessidades de acesso conhecidas | Persona |
| 3 | Checklist eMAG sem pendências | Checklist eMAG |
| 3 | Contraste conferido nas telas | Leitor de tela (contraste dos textos) |
| 4 | Acessibilidade documentada para o desenvolvimento | Leitor de tela, ordem de foco, trilha de gestos, Design Handoff (pacote de entrega) e Handoff de acessibilidade |
| 5 | Testado com leitor de tela | Resultado do teste registrado no Leitor de tela |
| 5 | Teste com pessoas com deficiência | Declaração do time ou do líder |
O critério do teste com pessoas com deficiência não tem evidência automática, porque nenhuma ferramenta consegue provar que pessoas com deficiência participaram dos testes. Só o time ou o líder pode declarar. E um item "não atende" no checklist bloqueia a estrela correspondente.
O que o CoboGov não faz
O CoboGov ajuda a projetar, verificar e documentar a acessibilidade, mas não testa o sistema pronto. Ele não substitui a avaliação do código, a validação com leitores de tela reais nem o teste com pessoas com deficiência. A responsabilidade pela acessibilidade do serviço e pelo cumprimento das normas aplicáveis é do órgão ou da equipe que o projeta e o mantém; o CoboGov é um apoio para essa tarefa.