← Todas as regras

ARIA

Alguns papéis exigem atributos próprios

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

Por que isso importa

Um papel como checkbox, slider ou combobox é uma promessa sobre o comportamento do controle. Sem os atributos exigidos, o estado não pode ser anunciado e o controle soa inutilizável.

Como corrigir

1. Acrescente os atributos que o papel exige (aria-checked em checkbox, aria-valuenow em slider).
2. Atualize-os em JavaScript a cada mudança de estado, não apenas na primeira renderização.
3. Um <input> nativo entrega tudo isso sem ARIA.

Na marcação

<div role="checkbox" tabindex="0">Subscribe</div>

<div role="checkbox" tabindex="0" aria-checked="false">Subscribe</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-required-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.