Le problème
Un résultat ajouté après clic peut échapper au lecteur d’écran. Le script peut aussi supprimer le focus ou désynchroniser un état : l’absence d’erreur JavaScript ne garantit pas l’accessibilité.
Pour vérifier vos interactions JavaScript 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="ajouter" type="button">Ajouter un exemplaire</button>
<p id="resultat">0 exemplaire ajouté</p>
<script>
let nombre = 0;
document.querySelector("#ajouter").addEventListener("click", () => {
nombre += 1;
document.querySelector("#resultat").textContent = `${nombre} exemplaire(s) ajouté(s)`;
});
</script>Correct
<button id="ajouter" type="button">Ajouter un exemplaire</button>
<p id="resultat" role="status" aria-atomic="true">0 exemplaire ajouté</p>
<script>
let nombre = 0;
document.querySelector("#ajouter").addEventListener("click", () => {
nombre += 1;
document.querySelector("#resultat").textContent = `${nombre} exemplaire(s) ajouté(s)`;
});
</script>Le rôle status est présent avant la mise à jour. Il permet de signaler le résultat sans déplacer le focus. aria-atomic="true" demande la restitution du message complet ; le rendu doit être vérifié avec le navigateur et le lecteur d’écran visés.
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 — Restituer noms, rôles et états.
- Critère 7.3 — Utiliser les interactions au clavier.
- Critère 7.4 — Contrôler les changements de contexte concernés.
- Critère 7.5 — Restituer les messages de statut.
- Critère 12.8 — Préserver l’ordre après les mises à jour.
Impact utilisateur
Une personne aveugle doit savoir si son action réussit. Au clavier, ajout de contenu, recherche ou validation doivent conserver un point de navigation stable.
Correction
- Gardez les commandes natives ; exposez les états des composants personnalisés. L’état annoncé d’un panneau doit suivre son affichage.
- Identifiez les vrais messages de statut : par exemple une confirmation, un nombre de résultats ou une erreur signalée sans changement de contexte. Utilisez role="status" pour une confirmation ordinaire ; pour un message d’erreur constituant un statut, vérifiez le rôle alert prévu par le test 7.5.2.
- Une liste complète de résultats n’est pas automatiquement un message de statut : annoncez plutôt le bilan utile. Déplacez le focus seulement lorsque la transition le justifie ; vérifiez les parcours après les réponses asynchrones et les échecs.
Besoin d’aide pour appliquer ces recommandations à vos interactions JavaScript ? 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
- Activez au clavier : chaque fonction doit rester utilisable sans souris.
- Au lecteur d’écran, actualisez le compteur : le résultat doit être restitué sans déplacement du focus.
- Testez erreurs, chargement et actions répétées : états et messages doivent refléter la situation sans annonces contradictoires ni perte de repère.
Points de vigilance
- Fonctionner sans JavaScript est une stratégie possible, pas une obligation universelle du RGAA.
- aria-live ne remplace pas les rôles, noms et interactions du composant.
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.
