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
- Choisissez d’abord button, a, input, label ou details selon le besoin. Leur sémantique réduit les comportements à reconstruire.
- Identifiez ce qui manque au widget : nom, état, valeur, relation ou notification. Vérifiez que le rôle autorise l’attribut.
- 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
- Inspectez l’arbre d’accessibilité : nom, rôle et états doivent refléter le composant.
- 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.
- 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.
