landmark-no-duplicate-banner
La page ne doit pas contenir plus d’un landmark banner
Vérifie que la page contient au plus un landmark banner (role="banner" ou un <header> non imbriqué).
Applicabilité. S’applique dès que la page contient au moins un landmark banner (role="banner" explicite, ou <header> implicite non imbriqué, détecté de la même façon que dans landmark-banner-is-top-level). 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. La page contient au plus un landmark banner. D’après les WAI-ARIA Authoring Practices, le landmark banner représente le contenu propre au site qui identifie la page dans son ensemble ; en avoir plusieurs est donc ambigu pour les utilisateurs de technologies d’assistance qui naviguent par landmarks.
Ce que rapporte un constat.
count: le nombre de landmarks banner que la page expose aux technologies d’assistance, pour une limite de 1.
Ces champs de data.details aident à lire et à reproduire un constat. À part reasonCode et les quelques champs que la page Schéma de sortie donne comme stables, ils ne constituent pas un contrat stable : un champ peut être renommé ou supprimé dans une version mineure, ne vous appuyez donc pas dessus.
Exemples
<body><header>Site header</header></body>
Il n’existe qu’un seul landmark banner.
<body><header>First</header><header>Second</header></body>
Deux éléments <header> de premier niveau prennent tous deux le rôle banner.
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_DUPLICATE_BANNER
- Ouvrez la liste des repères d’un lecteur d’écran, ou le panneau Accessibilité, et comptez les repères banner.
- Pour chacun de ceux qu’indique le rapport, déterminez s’il s’agit de l’en-tête de toute la page ou de l’en-tête d’une section, d’une carte ou d’une boîte de dialogue.
- Vérifiez que les copies masquées ou fermées (comme un header dans un menu fermé) sont réellement masquées aux technologies d’assistance.
Réussite. Les technologies d’assistance ne trouvent qu’un seul banner, l’en-tête de toute la page.
Échec. Plusieurs banners sont exposés : la navigation par repères propose plusieurs en-têtes de page, un manquement aux bonnes pratiques selon le rôle WAI-ARIA banner.