landmark-banner-is-top-level
Le landmark banner doit être de premier niveau
Vérifie que le landmark banner (role="banner" ou un <header> non imbriqué) n’est pas imbriqué dans une autre région landmark.
Applicabilité. S’applique dès que la page contient au moins un candidat banner : un role="banner" explicite, OU un <header> sans AUCUN attribut role, quelle que soit son imbrication. Un élément personnalisé auquel ses ElementInternals donnent un rôle de landmark (this.attachInternals().role), sans attribut role qui en nomme un autre, est un landmark au même titre qu’un élément natif doté de ce rôle.
Attendu. Aucun candidat banner n’a d’ancêtre qui soit lui-même une région landmark. Un banner imbriqué dans un autre landmark n’est pas un banner de premier niveau couvrant toute la page, et il perturbe la navigation par landmarks des utilisateurs de technologies d’assistance.
Exemples
<header>Site header</header>
Le banner n’est imbriqué dans aucun autre landmark.
<div role="navigation"><div role="banner">Nested banner</div></div>
Un landmark banner imbriqué dans un autre landmark ne joue plus le rôle d’en-tête unique de premier niveau de la page.
Comment vérifier
Quand cette règle ne peut pas trancher, elle renvoie cantTell et laisse la question à une personne. Chaque question qu’elle peut poser figure ici sous son code de raison, avec les étapes pour y répondre. Un constat porte les mêmes étapes dans howToCheck, dans la langue de l’analyse. Voir Schéma de sortie.
LANDMARK_BANNER_NOT_TOP_LEVEL
- Repérez le banner (un header ou role="banner") indiqué par le rapport et le repère dans lequel il se trouve.
- Ouvrez la liste des repères d’un lecteur d’écran, ou le panneau Accessibilité, et regardez où apparaît le banner.
- Déterminez s’il s’agit de l’en-tête de toute la page ; s’il s’agit de l’en-tête d’un article ou d’une section, il ne devrait pas être un banner.
Réussite. Le banner se trouve au premier niveau de la page, en dehors de tout autre repère.
Échec. Un banner se trouve dans un autre repère, ce qui perturbe la navigation par repères, un manquement aux bonnes pratiques selon le rôle WAI-ARIA banner.