Aller au contenu principal
Construire les composants et utiliser ARIA

aria-describedby : associer une aide ou une erreur à un champ

aria-describedby associe une description complémentaire : consigne ou erreur, par exemple. Il complète le nom du champ sans remplacer son étiquette.

Rédaction : RGAA Consulting · Références vérifiées le · RGAA 4.1.2

Le problème

Une aide non associée peut échapper au passage direct entre champs. Remplacer le label par cette aide fait entendre une règle sans identifier la donnée à saisir.

Exemple : mauvais et correct

Mauvais

<label for="reference">Référence du dossier</label>
<input id="reference" name="reference" required>
<p>Format : RG suivi de six chiffres.</p>

Correct

<label for="reference">Référence du dossier (obligatoire)</label>
<p id="reference-aide">Format : RG suivi de six chiffres.</p>
<input id="reference" name="reference" required
       aria-invalid="true"
       aria-describedby="reference-aide reference-erreur">
<p id="reference-erreur">
  Référence du dossier : vérifiez le préfixe RG et les six chiffres.
</p>

Le fragment corrigé montre une erreur après validation. Le label nomme le champ ; les id de l’aide et de l’erreur forment sa description.

RGAA concerné

Les critères dépendent de l’élément, de son usage et des cas particuliers applicables. Voici les contrôles à examiner pour ce sujet.

Impact utilisateur

Le lecteur d’écran doit fournir le format au moment de saisir. Associer champ et consigne évite de rechercher l’aide et facilite la correction d’une réponse refusée.

Correction

  1. Gardez une étiquette et des aides courtes visibles. Associez leurs id avec aria-describedby plutôt que de les ajouter au nom.
  2. Après validation, ajoutez l’erreur sans retirer l’aide utile. Après correction, actualisez message et aria-invalid ; n’affichez pas l’état invalide dès l’arrivée.
  3. Pour annoncer une nouvelle erreur, prévoyez si nécessaire déplacement du focus ou message de statut. aria-describedby établit une relation sans garantir l’annonce immédiate.

Méthode de test

  1. Chaque référence doit viser un id unique et une consigne présente.
  2. Au lecteur d’écran, prenez le focus : le nom attendu est « Référence du dossier (obligatoire) » ; la description doit fournir aide et erreur.
  3. Corrigez et validez : état et références doivent être actualisés, sans id orphelin ni ancienne erreur annoncée.

Points de vigilance

  • La restitution de la description varie selon le lecteur d’écran et ses réglages : contrôlez votre environnement.
  • Une description longue ou structurée doit rester navigable si l’annonce condensée ne suffit pas.

Sources officielles

Le RGAA fournit les critères de contrôle. Les ressources du W3C et du WHATWG complètent les méthodes de mise en œuvre ; elles ne remplacent pas les tests RGAA.