Pular para o conteúdo principal

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-labelledby e aria-describedby apontam 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-modal e 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ão alert (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.

AjusteOpções
Interface (escala)100%, 115% e 130%
Texto100%, 125% e 150%. Muda só as letras; os ícones mantêm o tamanho.
TemaIgual ao Figma, Claro ou Escuro
Espaçamento de textoMais espaço entre linhas, letras e palavras (WCAG 1.4.12)
Leitura em voz altaLê 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:

  1. em qual tela ou ferramenta aconteceu;
  2. qual tecnologia assistiva ou ajuste você usava (leitor de tela, zoom, voz alta, só teclado);
  3. 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.

EstrelasCritérioDe onde vem
1Nível pretendido (A, AA ou AAA) declaradoDados do projeto
2Necessidades de acesso conhecidasPersona
3Checklist eMAG sem pendênciasChecklist eMAG
3Contraste conferido nas telasLeitor de tela (contraste dos textos)
4Acessibilidade documentada para o desenvolvimentoLeitor de tela, ordem de foco, trilha de gestos, Design Handoff (pacote de entrega) e Handoff de acessibilidade
5Testado com leitor de telaResultado do teste registrado no Leitor de tela
5Teste com pessoas com deficiênciaDeclaraçã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.