Pular para o conteúdo principal
Ramplifica
Ramplifica blog

Passo a passo · Régua das Telas

Do desenho ao código sem perder a acessibilidade: a Régua das Telas em quatro etapas

As quatro etapas da Régua das Telas, do contexto à especificação, com o exemplo da tela de escolher o posto e o horário. O que o desenho não mostra vai, por escrito, para quem desenvolve.

Por Erik Henrique da Costa Nunes

· 8 min de leitura

Como citar

No desenho, o dia 18 do calendário é um quadrado azul com o número no meio. Quem vê a tela entende. O leitor de tela, se ninguém disser nada, anuncia “18” e mais nada: nem o mês, nem o dia da semana, nem se há horário livre. O desenho estava certo. O que faltou foi alguém escrever o que ele não mostra.

A Régua das Telas registra isso sobre a imagem da própria tela: a ordem do foco, os títulos, as regiões, os nomes acessíveis e os textos alternativos. Depois confere o que falta e entrega a especificação com os requisitos da NBR 17225. Neste guia, mostro as quatro etapas com o exemplo da ferramenta. Se quiser ler sobre as anotações antes, veja como a Régua das Telas funciona.

Antes de começar

Quanto tempo
Meia hora a uma hora por tela, conforme quantos botões, campos e títulos ela tem.
O que ter em mãos
Uma imagem da tela: uma captura ou o desenho exportado do Figma, em PNG, JPG ou WebP. Dá para marcar sem imagem, só na lista.
Com quem
Quem desenhou a tela anota, e quem vai programar lê a especificação. Uma conversa entre as duas pessoas no fim evita que algo se perca.
Onde fica salvo
No seu navegador, com a imagem, e ninguém mais tem acesso. A imagem não sai do computador. Para continuar em outro lugar, baixe o arquivo.

Etapa 1 de 4

Dizer que tela é

A primeira etapa diz de que página se fala e recebe a imagem.

Etapa Contexto. Os campos Nome da tela, com Escolher o posto e o horário; Título da página, com Escolher o posto e o horário · Carteira de Identidade Nacional; e Idioma da página, com pt-BR. Abaixo, Imagem da tela, com o botão de escolher arquivo, a miniatura da tela de exemplo, o tamanho, 800 × 600 pixels, e o botão Tirar a imagem.

Ver a imagem em tamanho real

  1. Nome da tela. É para a equipe e dá nome aos arquivos baixados.
  2. Título da página. Vai para o código: é o que aparece na aba do navegador e o leitor de tela anuncia primeiro. Diga o assunto da página e depois o site.
  3. Idioma da página. Já vem como pt-BR. Se a página for em outra língua, escreva o código dela, como en ou es.
  4. A imagem da tela. Fica reduzida a até 1.600 pixels de largura. Cada anotação guarda uma imagem só: escolha o estado da tela que mais precisa de explicação.

Assim

“Escolher o posto e o horário · Carteira de Identidade Nacional”

Assim não

“Página 2”

Etapa 2 de 4

Marcar sobre a imagem

Esta é a etapa central. Cada marcação é um retângulo sobre a imagem, com um selo: F de foco, H de título, R de região, N de nome acessível e A de texto alternativo.

Quadro A tela. A legenda dos selos e o grupo Mostrar na imagem, com cinco caixas marcadas: F, Ordem de foco; H, Título; R, Região; N, Nome acessível; e A, Texto alternativo. Abaixo, a imagem da tela de agendamento coberta de retângulos coloridos com selos: R1 no cabeçalho, F2 no menu, H1 no título Escolher o posto e o horário, N2 no campo do posto, F5 nos dias, N4 no dia 18, F6 nos horários, N3 no botão Continuar, R4 e A1 na coluna de documentos e R5 no rodapé.

Ver a imagem em tamanho real

  1. Mostrar na imagem. Desmarque um tipo para ver os outros com menos confusão.
  2. A imagem com as marcações. Cada retângulo tem o selo da marcação, que liga a imagem à lista e à especificação.

Abaixo da imagem, a lista de marcações. A ordem dela importa: é a ordem do foco do teclado e também a ordem em que a régua lê os níveis dos títulos.

Quadro 20 marcações. O texto diz que a ordem de foco é a ordem das marcações de foco nesta lista. O botão Acrescentar uma marcação. Abaixo, as marcações R1, Região: Cabeçalho; R2, Região: Navegação: Menu principal; e R3, Região: Conteúdo principal, cada uma com os botões Editar, Subir, Descer e Apagar.

Ver a imagem em tamanho real

  1. Acrescentar uma marcação. A marcação nova abre no tipo da última da lista: confira o tipo antes de escrever.
  2. Editar, Subir, Descer e Apagar. Subir e Descer mudam a ordem. Como a lista mistura todos os tipos, suba ou desça até uma marcação passar pela outra do mesmo tipo.

Editar abre o formulário da marcação. Os campos mudam com o tipo. Num nome acessível, por exemplo, pedem o que é, o texto visível e o nome que o leitor de tela anuncia.

Formulário Editar N4, Nome acessível: 18 de agosto, terça-feira, 4 horários livres (botão). O grupo O que marcar, com Ordem de foco, Título, Região, Nome acessível, marcado, e Texto alternativo, e os requisitos da NBR 17225 desse tipo. Os campos O que é, com Botão; Texto visível, com 18; Nome acessível, com 18 de agosto, terça-feira, 4 horários livres; e Observação para quem desenvolve, sobre aria-pressed e o dia sem horários. Embaixo, a posição do retângulo, Posição exata (em %) e os botões Guardar a marcação e Cancelar.

Ver a imagem em tamanho real

  1. O que marcar. O tipo da marcação, com os requisitos da NBR 17225 que valem para ele.
  2. Texto visível. O que aparece na tela. O nome acessível precisa conter esse texto, de preferência no começo: quem usa comando de voz fala o que vê.
  3. Nome acessível. O que o leitor de tela anuncia. Se ficar vazio, vale o texto visível.
  4. Observação para quem desenvolve. O que nenhum campo pergunta: o contraste de uma cor, a mensagem de erro, o que muda quando a pessoa escolhe uma opção.
  5. Posição exata (em %). Com a marcação aberta, arraste sobre a imagem para desenhar o retângulo, ou clique para levá-lo até ali. Sem mouse, leve o foco ao retângulo e use as setas para mover; com Shift, as setas mudam o tamanho. Aqui, dá para digitar a posição.

Assim

Nome acessível: “18 de agosto, terça-feira, 4 horários livres”.

Assim não

Nome acessível: “18”.

Etapa 3 de 4

Conferir o que falta

A régua confere as marcações e lista os problemas que encontra: título da página faltando, título que pula de nível, região sem nome, nome que não contém o texto visível, botão fora da ordem de foco. O exemplo não tem nada a conferir. Para a tela abaixo, apaguei o título da página e mudei o título Dia e horário para o nível 3.

Etapa Conferir, com o quadro 2 pontos para conferir. O aviso de que a régua confere só o que dá para ver nas marcações e não substitui o teste na página pronta. O primeiro ponto: falta o título da página, com o link NBR 17225, 5.13.1 Título da página e o botão Corrigir no Contexto. O segundo: H3 Dia e horário pula do nível 1 para o 3, com o link para o 5.3.5 Estrutura de cabeçalhos e o botão Corrigir a marcação.

Ver a imagem em tamanho real

  1. O ponto, com o que falta e por quê.
  2. O requisito da NBR 17225, que abre a Bússola numa aba nova.
  3. Corrigir. Leva ao lugar do conserto: o Contexto ou a marcação.
  4. Um título que pula de nível. Os títulos descem um nível por vez, na ordem da lista.

Um ponto sem corrigir não some: ele segue no texto da especificação, para quem desenvolve ver.

Etapa 4 de 4

Entregar a especificação

A última etapa escreve a especificação para quem desenvolve, agrupada por tipo de marcação, com os requisitos de cada grupo.

Etapa Especificação, no alto. O título Escolher o posto e o horário. A parte A página, com o título da página, o idioma lang="pt-BR" e os links dos requisitos 5.13.1 e 5.13.2 da NBR 17225. Depois, Ordem de foco, com F1 Logo do Instituto, F2 Menu, F3 Sair, F4 Campo Posto de atendimento, F5 Dias, com a observação de que hoje o foco pula o calendário inteiro, e F6 Horários.

Ver a imagem em tamanho real

  1. A página. O título e o idioma, com os requisitos.
  2. Um grupo por tipo de marcação, na ordem da lista. Quando cabe, cada marcação vem com o elemento HTML, como h1, nav ou a.
  3. As observações vão junto de cada marcação.

No fim do quadro, os botões para levar a especificação.

Fim da especificação. Os botões Copiar a especificação, Baixar em texto, Baixar as marcações (.csv) e Baixar a imagem marcada (.png). Abaixo, o quadro da Régua dos Textos: legibilidade 14, muito difícil, nenhum ponto de atenção.

Ver a imagem em tamanho real

  1. Copiar a especificação. Ao lado, Baixar em texto e Baixar as marcações (.csv). O texto traz tudo; a planilha traz só as marcações, uma por linha.
  2. Baixar a imagem marcada. A imagem com os retângulos e os selos, como F1 e R1, que ligam cada retângulo à linha do texto. Mande junto com o texto.
  3. A nota de legibilidade. A Régua dos Textos mede os títulos, rótulos, nomes e textos alternativos da tela. Para melhorar, teste na Régua dos Textos e ajuste em Marcar.

E depois da especificação?

  • Simplificar os textos. Teste os nomes e os textos alternativos na Régua dos Textos.
  • Ler os requisitos. A Bússola da NBR 17225 explica cada um, com exemplos.
  • Testar quando ficar pronto. Na página programada, passe pelo caminho só com o teclado e com um leitor de tela. A Lupa das Boas Práticas ajuda a avaliar o serviço inteiro.

Erros comuns

  • Marcar só o que é fácil de ver. Os botões de ícone, sem texto, são os que mais precisam de nome acessível.
  • Nome acessível sem o texto visível. Se o botão diz “Continuar”, o nome precisa ter “Continuar”.
  • Esquecer a ordem da lista. Uma marcação de foco fora do lugar vira uma ordem de foco errada na especificação.
  • Trocar a imagem e não conferir os retângulos. As marcações ficam onde estavam e não acompanham o desenho novo.

Quando o trabalho é em equipe

A Régua das Telas não está na área logada. Hoje, a anotação fica no navegador de quem preenche. Para outra pessoa continuar, baixe o arquivo, que leva a imagem junto, e mande para ela, que abre com Abrir arquivo salvo, no Contexto. Cada arquivo é uma cópia: o que duas pessoas mudam não se junta.

Para quem vai programar, o que circula é a especificação: o texto ou a planilha, junto com a imagem marcada.

Perguntas frequentes

A imagem da tela vai para algum servidor?

Não. A imagem fica neste navegador e só sai dele no arquivo que você baixar.

Preciso saber programar?

Não. A especificação já traz o elemento HTML de cada título, região e nome, quando cabe. Os outros campos pedem o que a pessoa vê e ouve, não código.

Dá para anotar várias telas?

Cada anotação guarda uma tela. Para outra, baixe o arquivo desta e comece uma nova. Os outros estados da mesma tela, como um aviso aberto, vão na observação de uma marcação.

O quadrado azul com o número 18 vai continuar igual no desenho. A diferença é que agora alguém escreveu, ao lado dele, o que o leitor de tela precisa dizer.

Anote a sua tela

Comece com o exemplo do agendamento para ver as marcações prontas, ou ponha a imagem da sua tela.

Anotar uma tela

Leia também

  • Passo a passo

    Do roteiro às notas: as entrevistas da Prancheta em sete etapas

  • Passo a passo

    Seis pessoas, uma conversa: os grupos focais da Prancheta em sete etapas

  • Passo a passo

    O mesmo serviço, três caminhos: o Mapa da Jornada em quatro etapas