Aller au contenu
SilktideAide

Rôle ARIA invalide

Silktide vérifie chaque attribut role de vos pages par rapport à la liste des rôles définis par la norme ARIA. Un rôle mal orthographié, inventé, vide ou réservé à un usage interne est ignoré silencieusement par les navigateurs, si bien que la signification prévue de l’élément n’atteint jamais les personnes qui en dépendent.

<!-- Problème : \"buton\" n'est pas un rôle valide ; ce div reste sans sémantique -->
<div role=\"buton\" tabindex=\"0\">Enregistrer</div>

<!-- Correctif : utilisez un rôle valide (ou mieux, un véritable élément button) -->
<button>Enregistrer</button>

Pourquoi c'est important

Un indique aux ce qu’est un oùn élément — un bouton, un onglet, une boîte de dialogue. Lorsque le rôle est invalide, les navigateurs l’ignorent : un utilisateur de entend du texte brut là où l’auteur avait prévu un contrôle, et peut ne pas savoir que l’élément est interactif. Comme la page semble et fonctionne normalement pour les utilisateurs voyants à la souris, ces erreurs passent inaperçues sans tests.

Comment corriger

  1. Corrigez les fautes de frappe afin que le rôle corresponde à un véritable rôle ARIA (liste complète) — par exemple role=\"navigation\", et non role=\"nav\".
  2. Remplacez les rôles abstraits (widget, composite, landmark, section, et similaires) par un rôle concret — les rôles abstraits existent uniquement pour organiser la norme et ne doivent pas être utilisés dans les pages.
  3. Supprimez les attributs vides role=\"\".
  4. Lorsqu’un élément natif porte la bonne sémantique (<button>, <nav>, <main>), préférez-le et supprimez complètement l’attribut role.

Comment Silktide teste ceci

  1. Trouver chaque élément de la page possédant un attribut role.
  2. Signaler les valeurs de rôle vides.
  3. Vérifier chaque mot de la valeur de role par rapport aux rôles définis par ARIA 1.2. Les rôles des extensions de publication numérique (doc-) et graphiques (graphics-) sont acceptés.
  4. Signaler les mots qui ne correspondent à aucun rôle défini et ceux qui désignent un rôle abstrait.

Dépannage

Le rôle comporte plusieurs mots

Un attribut role peut lister plusieurs rôles de repli ; les navigateurs utilisent le premier qu’ils reconnaissent. Silktide signale chaque mot invalide ou abstrait de la liste afin que vous puissiez aussi nettoyer les rôles de repli.

Ce contrôle ne signale rien alors que je m’attendais à des résultats

Les tests ARIA peuvent être désactivés pour un site web donné. Vérifiez les paramètres avancés du site web.

Pour aller plus loin

Dernière mise à jour

Cette page vous a-t-elle été utile ?

Rôle ARIA invalide | Centre d’aide Silktide