Construire les composants et utiliser ARIA

ARIA : compléter le HTML sans contredire le comportement

ARIA complète les rôles, états et propriétés exposés aux technologies d’assistance. Commencez par le HTML natif adapté, puis ajoutez les informations manquantes.

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

Le problème

Un panneau ouvert peut manquer d’état annoncé ; un état désynchronisé peut aussi mentir. ARIA décrit l’interface sans implémenter clavier, affichage ni gestion du focus.

Pour vérifier vos composants utilisant ARIA dans vos parcours réels, notre audit RGAA de votre site identifie les obstacles et vous fournit un rapport pour prioriser les corrections.

Exemple : mauvais et correct

Mauvais

<button id="commande" type="button">Périmètre du contrôle</button>
<div id="panneau" hidden><p>Le contrôle porte sur les parcours retenus.</p></div>
<script>
  const commande = document.querySelector("#commande");
  commande.addEventListener("click", () => {
    const panneau = document.querySelector("#panneau");
    panneau.hidden = !panneau.hidden;
  });
</script>

Correct

<button id="commande" type="button"
        aria-expanded="false" aria-controls="panneau">
  Périmètre du contrôle
</button>
<div id="panneau" hidden><p>Le contrôle porte sur les parcours retenus.</p></div>
<script>
  const commande = document.querySelector("#commande");
  commande.addEventListener("click", () => {
    const panneau = document.querySelector("#panneau");
    panneau.hidden = !panneau.hidden;
    commande.setAttribute("aria-expanded", String(!panneau.hidden));
  });
</script>

Le bouton reste natif. aria-expanded expose l’état ouvert ou fermé ; le script synchronise cet état avec hidden. aria-controls référence le panneau : cette relation est facultative dans le modèle APG de panneau dépliable.

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.

  • Critère 7.1 — Exposer notamment le rôle et les changements d’état du panneau scripté.
  • Critère 7.3 — Permettre l’activation de sa commande au clavier et au pointage.

Impact utilisateur

Un lecteur d’écran peut annoncer commande, état ou résultat. Une déclaration erronée masque des informations ou promet un comportement que la personne ne retrouve pas au clavier.

Correction

  1. Choisissez d’abord button, a, input, label ou details selon le besoin. Leur sémantique réduit les comportements à reconstruire.
  2. Identifiez ce qui manque au widget : nom, état, valeur, relation ou notification. Vérifiez que le rôle autorise l’attribut.
  3. Synchronisez propriétés et réalité. aria-expanded n’affiche rien ; aria-disabled n’empêche pas seul l’activation. La logique doit correspondre à l’annonce.

Besoin d’aide pour appliquer ces recommandations à vos composants utilisant ARIA ? Notre accompagnement en mise en conformité RGAA vous aide à corriger les écarts et à vérifier les résultats avec vos équipes.

Méthode de test

  1. Inspectez l’arbre d’accessibilité : nom, rôle et états doivent refléter le composant.
  2. Avec Tab, atteignez le bouton. Ouvrez et fermez avec Entrée puis Espace ; au lecteur d’écran, vérifiez que l’état suit chaque action.
  3. Vérifiez les identifiants et les attributs autorisés par le rôle et l’élément HTML. Complétez les outils automatiques par le parcours du composant.

Points de vigilance

  • aria-label peut remplacer le nom fourni par le texte visible : l’ajouter par défaut peut dégrader le résultat.
  • Un modèle APG aide à implémenter ; sa présence ne prouve pas la conformité du site.

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.

Un projet de création ou de refonte ?

Intégrez ces bonnes pratiques dès la conception de vos pages et composants, avec un accompagnement adapté à votre projet.

Découvrir notre développement accessible