Skip to content

Esta tradução ainda não foi revista editorialmente. A versão alemã é vinculativa. Deutsche Fassung →

Barrierefreiheit

Por que o rótulo visível deve aparecer no nome armazenado?

O rótulo visível de um controle deve aparecer em seu nome armazenado, legível por máquina, porque os usuários de controle de voz falam o que veem: quem diz «Clique em Enviar» atinge o botão apenas se seu nome armazenado contiver a palavra «Enviar». Se o nome invisível divergir, o comando de voz funciona em vão. O critério WCAG 2.5.3 «Rótulo no Nome» previne exatamente essa divergência.

Texto visível e nome armazenado podem divergir

Cada controle carrega, além do texto visível, um nome legível por máquina que programas leitores e controle de voz usam. Normalmente, ambos são idênticos. Eles diferem quando desenvolvedores sobrescrevem intencionalmente o nome no código-fonte — muitas vezes com boa intenção, para dar aos programas leitores mais contexto. Um exemplo: o botão mostra «Solicitar oferta», o nome armazenado é «Abrir formulário de contato». Um usuário de controle de voz diz «Clique em Solicitar oferta» — e nada acontece, porque um elemento desse nome não existe para o software. A regra é simples: o nome armazenado pode complementar, mas deve conter a redação visível, de preferência na primeira posição.

Como o serviço de verificação testa o rótulo no nome

A medição encontra todos os links e botões cujo nome foi sobrescrito e compara o texto visível e o nome armazenado diretamente no código-fonte da página carregada. Se a redação visível estiver completamente ausente no nome, o relatório marca uma violação com ambos os textos. Correspondências parciais são marcadas como um ponto de verificação manual, descrições de símbolos como um «X» para fechar permanecem excluídas.

Beispiele

Hinterlegter Name ohne die sichtbare Beschriftung

Verstoß
<button aria-label="Absenden">Anfrage schicken</button>
Erfüllt
<button>Anfrage schicken</button>
<!-- oder: aria-label="Anfrage schicken an den Vertrieb" -->

Sprachsteuerung sagt „Klicke Anfrage schicken“. Der zugängliche Name muss den sichtbaren Text enthalten, am besten am Anfang.

  • Peça à sua agência para listar todos os nomes sobrescrito no código-fonte e compará-los com os rótulos visíveis.
  • Coloque a redação visível no início do nome armazenado; complementos vêm depois.
  • Evite nomes sobrescrito onde o texto visível já diz tudo — nenhum nome é melhor do que um divergente.
  • Teste esporadicamente com controle de voz de seu telefone: diga a redação visível de um botão e verifique se ele responde.

Deutsche Fassung dieser Seite