Repère

Ce que c'est

Un repère, aussi appelé région de repère ou repère ARIA, est une
partie d'une page web dont le balisage nomme la fonction — en-tête
du site, contenu principal, navigation ou pied de page — pour que
les technologies d'assistance puissent énumérer ces parties et
atteindre directement chacune d'elles. Une page comporte
généralement plusieurs repères ; ensemble, ils décrivent sa
disposition à une personne qui ne la voit jamais.

WAI-ARIA 1.2 définit huit rôles de repère : `banner`, `navigation`,
`main`, `complementary`, `contentinfo`, `search`, `form` et
`region`. Un neuvième, `landmark` lui-même, est le parent abstrait
du modèle de rôles de la spécification, qui demande aux auteurs de
ne pas l'utiliser. La plupart des pages n'ont jamais besoin de
l'attribut `role` pour obtenir les autres, car les éléments HTML les
portent déjà :

  * `main` est le repère `main`, et `nav` un repère `navigation`.

  * `header` et `footer` ne deviennent `banner` et `contentinfo` que
s'ils appartiennent à la page entière. Placés dans un `article`, une
`section` ou `main`, ils relèvent de la structure ordinaire de la
page et ne sont pas des repères.

  * `aside` est `complementary` au niveau supérieur de la page ou
dans `main`. Dans les autres contenus de sectionnement, il ne compte
que s'il possède un nom.

  * `section` ne devient un repère `region` que si elle possède un
nom accessible, fourni par `aria-label` ou par un titre référencé
avec `aria-labelledby`. Une `section` sans nom n'est qu'un groupe.

  * `form` correspond au rôle `form`, et la spécification exige des
auteurs qu'ils lui donnent un libellé. L'élément plus récent
`search` correspond à `search`.

La spécification demande aux technologies d'assistance de permettre
un accès rapide à ces régions, et les lecteurs d'écran le font. Dans
NVDA, `D` passe au repère suivant et la liste des éléments les
présente tous à la fois ; le rotor de VoiceOver possède sa propre
liste de repères. Une personne qui arrive sur une page peut ouvrir
cette liste, entendre qu'elle comporte une bannière, une navigation,
une région principale et un pied de page, et connaître sa structure
avant d'en lire un mot.

Pourquoi c'est important

La décision sous-jacente est de savoir si chaque partie de la page
se trouve à un endroit qu'une personne à l'écoute peut nommer et
atteindre. Sur une page habituelle, la majeure partie du contenu se
répète : en-tête, menu, pied de page et souvent barre latérale sont
identiques sur toutes les pages du site, et la partie nouvelle se
trouve quelque part au milieu. Le regard d'une personne voyante s'y
porte directement. Sans repères, une personne utilisant un lecteur
d'écran doit écouter le même en-tête et le même menu sur chaque
page, ou deviner combien de titres sauter.

La technique WCAG consacrée aux repères, ARIA11, figure parmi les
moyens suffisants de satisfaire trois critères de succès. L'un
demande un moyen de sauter les blocs de contenu répétés entre les
pages ; un autre exige que la structure perçue dans la disposition
par une personne voyante soit également accessible au logiciel. Le
coût est faible si la page est construite dès le départ avec
`header`, `nav`, `main` et `footer` : la sémantique vient avec
l'élément, sans rien de plus à maintenir. Ajouter des repères après
coup à une disposition faite de `div` imbriqués coûte davantage,
mais le travail reste surtout mécanique.

Deux limites sont à connaître. La première est que la spécification
laisse la navigation par repères facultative pour les navigateurs
courants : les repères seuls n'apportent généralement rien à une
personne au clavier sans lecteur d'écran, et un lien d'évitement
visible garde son utilité. La seconde est qu'ajouter des repères ne
rend pas une page plus facile à utiliser. Chacun est une entrée de
liste que quelqu'un doit écouter ; une page dont chaque bloc est une
région nommée se lit comme une table des matières de cinquante
lignes. La spécification réserve `region` au contenu assez important
pour figurer dans un résumé de la page et demande de ne l'utiliser
que si aucun autre rôle ne décrit sa fonction.

À quoi cela ressemble en pratique

La marque figurant sur chaque page intérieure se trouvait hors de
tout repère et rien à l'écran ne le révélait, situation typique d'un
défaut visible seulement dans la structure. Il est apparu pendant le
travail visant à amener tout le site au niveau AA de WCAG 2.2.
L'automatisation exécute un moteur de règles d'accessibilité avec
les règles de bonnes pratiques activées, et pas seulement celles de
conformité — une différence de trente règles —, et l'une des règles
supplémentaires a échoué dès son activation.

Les contrôles expliquent comment le défaut était passé inaperçu.
Parmi onze défauts présents malgré des contrôles du navigateur au
vert, deux se trouvaient dans les contrôles plutôt que dans les
pages ; l'un était que le moteur n'exécutait que soixante-dix de ses
cent cinq règles. Celle qui aurait détecté le repère manquant était
simplement absente de l'ensemble. La leçon est courte : un jeu de
règles qui ne contient pas une règle ne peut pas la faire respecter.

Hors du site principal, la page d'accueil de la forge Git propre à
l'entreprise avait été une copie du design du site principal
maintenue à la main, et toutes les différences relevées entre les
deux s'étaient révélées accidentelles plutôt que délibérées. L'une
des cinq était qu'aucune page ne possédait de repère principal ni de
titre de premier niveau ; aucune des cinq n'était visible sur une
capture d'écran. La copie a été supprimée et la page d'accueil est
désormais construite par les modèles du site principal lui-même :
elle hérite donc de la même structure au lieu de l'imiter.

Où les problèmes surviennent

Les erreurs de repères sont silencieuses à l'écran et évidentes à
l'écoute avec un lecteur d'écran. Voici les plus courantes.

Du contenu se trouve hors de tout repère. Un logo, un avis sur les
cookies ou un sélecteur de langue est placé avant `header` ou après
`footer`, et une personne qui se déplace par repères le saute. La
règle `region` d'axe signale tout contenu non inclus dans un repère,
mais elle est classée comme bonne pratique plutôt que comme échec
WCAG : une exécution limitée aux étiquettes WCAG ne l'exécute
jamais. Activez les règles de bonnes pratiques et déplacez l'élément
égaré dans le repère auquel il appartient.

Le même rôle apparaît deux fois avec le même nom. Deux éléments
`nav`, l'un dans l'en-tête et l'autre dans le pied de page, sont
tous deux annoncés « navigation », et la personne doit deviner
lequel est lequel. Donnez à chacun un libellé court et distinct avec
`aria-label` ou `aria-labelledby`, sans inclure le rôle dans le
libellé : une navigation nommée « Navigation du site » est lue
« Navigation du site navigation ».

Un deuxième repère principal ou une deuxième bannière apparaît. Un
`div` reçoit `role="main"` ou `role="banner"` pour donner de
l'importance à un composant, ou un modèle entoure une page
intérieure de son propre `main` : la page annonce alors deux
occurrences d'un rôle qui devrait être unique. La spécification
demande au plus un `banner`, un `main` et un `contentinfo` par page,
et axe possède une règle pour chacun. Vérifiez la liste des repères
après chaque modification de disposition et laissez les éléments
natifs porter les rôles chaque fois qu'ils le peuvent.

Chaque bloc devient une région. Une bibliothèque de composants
attribue à chaque `section` un `aria-label` par défaut, et la liste
des repères se remplit de titres de cartes. Ne nommez une `section`
que si une personne souhaiterait y accéder depuis n'importe quel
endroit de la page.

Une page ayant la forme de l'esquisse ci-dessous offre cinq étapes
distinctes à une personne à l'écoute :

```html
<header><!-- logo, search --></header>
<nav aria-label="Site"><!-- menu --></nav>
<main>
    <h1>Prices</h1>
    <section aria-labelledby="hosting">
        <h2 id="hosting">Hosting</h2>
    </section>
</main>
<footer><!-- contact, legal --></footer>
```

Pour aller plus loin

  * WAI-ARIA 1.2 : rôles de repère — les huit rôles, la fonction de
chacun et ceux qui doivent porter un libellé.

  * Régions de repère — le guide de rédaction du W3C sur le choix
des rôles, les libellés des repères répétés et l'inclusion de tout
contenu dans un repère.

  * Correspondances HTML vers les API d'accessibilité 1.0 —
correspondance des éléments HTML avec les rôles, y compris les
conditions dans lesquelles `header`, `footer`, `aside` et `section`
comptent comme repères.

  * ARIA11 : utiliser les repères ARIA pour identifier les régions
d'une page — la technique WCAG, sa procédure de test et les critères
de succès qu'elle satisfait.

hCette page sur le Web	URL:https://engineer.company/fr/glossary/landmark/	engineer.company	70
