← Todas as regras

ARIA

Os nomes dos atributos ARIA precisam ser válidos

• Regra: aria-valid-attr
• Gravidade: Crítico
• Nível WCAG A

Por que isso importa

Um atributo escrito errado (aria-labeledby com um “l” só) não é um erro que o navegador reporte. Ele é simplesmente ignorado: o nome acessível que você achou que definiu nunca foi definido.

Como corrigir

1. Corrija a grafia conforme a especificação ARIA.
2. Remova atributos inventados — ARIA não tem aria-role, aria-title nem aria-alt.
3. Ative um linter de acessibilidade no editor para que isso falhe antes da revisão.

Na marcação

<input aria-labeledby="email-label">

<input aria-labelledby="email-label">

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-valid-attr (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.