Nomes e papéis

Resumos de bloco expansível precisam de texto

Regra: summary-name
Gravidade: Grave
Nível WCAG A

Por que isso importa

Um <summary> vazio deixa o controle de expandir e recolher sem nome: ouve-se “recolhido” sem saber o que está escondido.

Como corrigir

Coloque o título da seção dentro do <summary>.
Mantenha-o curto — ele é ao mesmo tempo o nome do controle e o título visível.

Na marcação

Falha

<details>
  <summary></summary>
  <p>Shipping is free above 50 EUR.</p>
</details>

Passa

<details>
  <summary>Shipping costs</summary>
  <p>Shipping is free above 50 EUR.</p>
</details>

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 summary-name (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.