Noms et rôles

Les résumés de bloc dépliant ont besoin de texte

Règle: summary-name
Gravité: Sérieux
Niveau WCAG A

Pourquoi c’est important

Un <summary> vide laisse la commande d’ouverture sans nom : on entend « réduit » sans savoir ce qui est masqué.

Comment corriger

Placez le titre de la section dans le <summary>.
Gardez-le court : il est à la fois le nom du composant et le titre visible.

Dans le balisage

Échoue

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

Réussit

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

L’exigence sous-jacente

Cette règle est une manière d’échouer aux critères de succès WCAG 2.2 suivants. Le W3C, qui rédige la norme, explique chacun d’eux :

4.1.2 Nom, rôle et valeur (s’ouvre dans un nouvel onglet) — Niveau WCAG A

Pour aller plus loin

Deque University sur summary-name (s’ouvre dans un nouvel onglet)

Deque développe axe-core, le moteur open source utilisé par notre scanner. Sa page documente la règle telle que le moteur l’implémente.

Les contrôles automatiques trouvent les défaillances qu’un navigateur peut prouver. Ils ne peuvent pas juger si un sous-titrage est fidèle, si une alternative textuelle est utile, ni si une page s’utilise de bout en bout au clavier : cela demande une personne.