← Todas as regras

ARIA

Alguns elementos não podem receber nome em ARIA

• Regra: aria-prohibited-attr
• Gravidade: Grave
• Nível WCAG A

Por que isso importa

Um elemento genérico — uma div ou span sem papel — não pode ter nome. As tecnologias assistivas ignoram aria-label ali, então o rótulo que você escreveu nunca é lido.

Como corrigir

1. Dê ao elemento um papel que aceite nome, ou use um elemento semântico como <section>, <nav> ou um título.
2. Se o rótulo serve apenas para quem enxerga, use texto visível.
3. Remova aria-label quando o elemento for decorativo.

Na marcação

<div aria-label="Latest news">Latest news</div>

<section aria-label="Latest news">Latest news</section>

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-prohibited-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.