# Onglets accessibles : rôles ARIA et flèches du clavier

Source: https://allyway.ai/fr/glossary/onglets-accessibles

Des onglets accessibles forment une interface à onglets dont les onglets sont exposés comme une liste d’onglets avec un état sélectionné, se commandent au clavier et sont reliés au panneau qu’ils affichent. Ils relèvent du critère WCAG 4.1.2 Nom, rôle et valeur, au niveau A, car les widgets à onglets personnalisés doivent indiquer leur rôle et leur état aux technologies d’assistance.

Des onglets accessibles sont des interfaces à onglets – fiches produit, grilles tarifaires, pages de paramètres – que tous les visiteurs peuvent utiliser, et pas seulement ceux qui ont une souris. De nombreux widgets à onglets sont construits avec des `div` et des gestionnaires de clic. Ils ressemblent à des onglets, mais un lecteur d’écran annonce du simple texte, le clavier ne peut pas les atteindre et personne n’entend quel onglet est ouvert. Un panneau à onglets accessible exige les bons rôles, un état sélectionné et un fonctionnement au clavier prévisible.

## Ce que cela signifie

HTML n’a pas d’élément natif pour les onglets, donc chaque widget à onglets est un composant personnalisé. Il relève ainsi du critère [WCAG 4.1.2 Nom, rôle et valeur](https://www.w3.org/WAI/WCAG22/Understanding/name-role-value.html) (niveau A) : pour les composants gérés par script, le [nom, le rôle et la valeur](https://allyway.ai/fr/glossary/nom-role-et-valeur) doivent pouvoir être déterminés par un programme informatique, et les changements d’état doivent être accessibles aux technologies d’assistance. Le [modèle Tabs](https://www.w3.org/WAI/ARIA/apg/patterns/tabs/) du W3C, dans les ARIA Authoring Practices, décrit la marche à suivre :

| Élément | Rôle et attributs |
|---|---|
| Conteneur des onglets | `role="tablist"`, une étiquette via `aria-label` ou `aria-labelledby` |
| Chaque onglet | `role="tab"`, `aria-selected="true"` sur l’onglet actif, `false` sur les autres, `aria-controls` pointant vers son panneau |
| Chaque panneau | `role="tabpanel"`, `aria-labelledby` pointant vers son onglet |
| Liste d’onglets verticale | `aria-orientation="vertical"` (l’orientation horizontale est la valeur par défaut) |

Le fonctionnement au clavier :

| Touche | Effet |
|---|---|
| Tab | Place le focus sur l’onglet actif, puis fait sortir de la liste d’onglets vers le panneau |
| Flèche gauche / droite | Passe d’un onglet à l’autre, du dernier au premier en fin de liste |
| Début / Fin (facultatif) | Va au premier ou au dernier onglet |
| Entrée / Espace | Active l’onglet qui a le focus si les onglets ne s’activent pas automatiquement |

Seul l’onglet actif fait partie de l’ordre de tabulation (`tabindex="0"`), les autres reçoivent `tabindex="-1"` – les flèches permettent de passer de l’un à l’autre. C’est la technique du « tabindex itinérant » (roving tabindex) décrite dans [tabindex](https://allyway.ai/fr/glossary/tabindex).

> **Tip:** > **Activation automatique ou manuelle ?**
> Le W3C recommande d’afficher un panneau dès que son onglet reçoit le focus seulement si le panneau apparaît sans délai perceptible. Si les panneaux chargent du contenu depuis le serveur, laissez les utilisateurs confirmer avec Entrée ou Espace.

## Exemples

```html title="Exemple"
<div role="tablist" aria-label="Product information">
  <button role="tab" id="tab-1" aria-selected="true"
          aria-controls="panel-1" tabindex="0">Description</button>
  <button role="tab" id="tab-2" aria-selected="false"
          aria-controls="panel-2" tabindex="-1">Sizes</button>
  <button role="tab" id="tab-3" aria-selected="false"
          aria-controls="panel-3" tabindex="-1">Reviews</button>
</div>

<div role="tabpanel" id="panel-1" aria-labelledby="tab-1" tabindex="0">
  <p>Hand-knitted wool scarf, 180 cm long.</p>
</div>
<div role="tabpanel" id="panel-2" aria-labelledby="tab-2" tabindex="0" hidden>…</div>
<div role="tabpanel" id="panel-3" aria-labelledby="tab-3" tabindex="0" hidden>…</div>
```

Un lecteur d’écran annonce alors quelque chose comme « Product information, liste d’onglets – Description, onglet, sélectionné, 1 sur 3 ». Le script modifie `aria-selected`, `tabindex` et `hidden` quand un autre onglet est choisi. Les éléments `<button>` donnent aux onglets une base de [navigation au clavier](https://allyway.ai/fr/glossary/navigation-au-clavier) avant même l’exécution du script.

**Do:** À faire

Utiliser `tablist`, `tab` et `tabpanel`, garder `aria-selected` synchronisé, prendre en charge les flèches du clavier, conserver un contour de focus visible sur l’onglet actif, donner une étiquette à la liste d’onglets.

**Don't:** À éviter

Fabriquer des onglets avec des liens qui rechargent la page tout en se faisant passer pour des onglets, placer `role="tab"` sur un élément de liste qui entoure le vrai lien, laisser tous les onglets dans l’ordre de tabulation sans flèches du clavier, indiquer l’onglet actif uniquement par la couleur.

## Comment vérifier des onglets accessibles



## Questions fréquentes

Q: Comment rendre des onglets accessibles ?
A: Donnez `role="tablist"` au conteneur, `role="tab"` avec `aria-selected` et `aria-controls` à chaque onglet, et `role="tabpanel"` à chaque panneau. Ajoutez ensuite la navigation aux flèches et ne laissez que l’onglet actif dans l’ordre de tabulation.

Q: Faut-il changer d’onglet avec les flèches ou avec la touche Tab ?
A: Les flèches permettent de passer d’un onglet à l’autre ; la touche Tab sert à entrer dans la liste d’onglets et à en sortir. C’est le modèle des ARIA Authoring Practices du W3C, et ce qu’attendent les utilisateurs de lecteurs d’écran.

Q: Les onglets ont-ils besoin de aria-controls ?
A: Le modèle W3C place `aria-controls` sur chaque onglet, vers son panneau, et `aria-labelledby` sur le panneau, vers son onglet. Ensemble, ils indiquent aux technologies d’assistance quel onglet affiche quel contenu.

Q: Les onglets sont-ils mauvais pour l’accessibilité ?
A: Pas s’ils suivent le modèle. Les problèmes viennent des widgets personnalisés sans rôles ni états. Si le contenu est court, de simples titres ou un accordéon peuvent être plus faciles à utiliser pour tout le monde.

Q: Quel critère WCAG s’applique aux onglets ?
A: Principalement le 4.1.2 Nom, rôle et valeur, ainsi que le 2.1.1 Clavier et le 2.4.7 Visibilité du focus – tous font partie des [WCAG 2.2](https://allyway.ai/fr/regulations/wcag-2-2).
