Rampsight

Todas as regras

ARIA

O corpo da página não pode ser ocultado das tecnologias assistivas

Por que isso importa

aria-hidden="true" no <body> remove a página inteira da árvore de acessibilidade. O leitor de tela anuncia um documento vazio: para ele, nada existe na página.

Como corrigir

  1. Remova o aria-hidden do <body>.
  2. Se um modal precisa que o resto da página seja ignorado, marque o contêiner irmão como inert (ou aria-hidden), nunca o próprio body.
  3. Revise o código que abre diálogos: quase sempre é uma limpeza que não foi executada.

Na marcação

Falha
<body aria-hidden="true">...</body>
Passa
<body>
  <div aria-hidden="true" class="decorative-backdrop"></div>
</body>

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:

Para aprofundar

Deque University sobre aria-hidden-body (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.