← Todas as regras

ARIA

aria-roledescription precisa de um papel para descrever

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

Por que isso importa

O atributo substitui o nome falado de um papel. Em um elemento sem papel não há o que substituir: ele é descartado e a redação escolhida nunca chega a ninguém.

Como corrigir

1. Dê primeiro um papel explícito ao elemento, depois descreva-o.
2. Mantenha a descrição curta e no idioma da página — ela é lida toda vez.
3. Não renomeie um papel conhecido por enfeite: “Slide” ajuda, “Caixa bonita” não.

Na marcação

<div aria-roledescription="Slide">...</div>

<div role="group" aria-roledescription="Slide" aria-label="1 of 5">...</div>

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-roledescription (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.