← Todas as regras

ARIA

Rótulos em braille exigem um equivalente em texto

• Regra: aria-braille-equivalent
• Gravidade: Grave
• Nível WCAG A

Por que isso importa

aria-braillelabel e aria-brailleroledescription só são apresentados em uma linha braille. Sem um aria-label correspondente, o controle fica sem nome nenhum para quem usa voz sintetizada.

Como corrigir

1. Acrescente aria-label (ou aria-roledescription) junto ao atributo de braille.
2. Mantenha os dois coerentes: a versão em braille abrevia o mesmo nome, não diz outra coisa.
3. Sem um motivo específico, remova o atributo de braille — um rótulo comum funciona em todo lugar.

Na marcação

<button aria-braillelabel="Sv">Save</button>

<button aria-label="Save" aria-braillelabel="Save">Save</button>

A exigência por trás disso

Esta regra é uma das formas de falhar nos seguintes critérios de sucesso das WCAG 2.2. O W3C, que publica a norma, explica cada um deles:

• 4.1.2 Nome, função e valor (abre em nova aba) — Nível WCAG A

Para aprofundar

Deque University sobre aria-braille-equivalent (abre em nova aba)

A Deque mantém o axe-core, o motor de código aberto que o nosso scanner executa. A página deles documenta a regra como o motor a implementa.

Verificações automáticas encontram falhas que o navegador consegue comprovar. Elas não julgam se uma legenda está correta, se um texto alternativo é útil, nem se a página pode ser operada de ponta a ponta pelo teclado — isso exige uma pessoa.