# Piège au clavier (WCAG 2.1.2) : explication et solutions

Source: https://allyway.ai/fr/glossary/piege-au-clavier

Un piège au clavier est une partie de page dans laquelle le focus clavier peut entrer, mais dont il ne peut pas sortir avec le clavier seul. Le critère WCAG 2.1.2 Pas de piège au clavier l’interdit au niveau A.

Un piège au clavier est un endroit de la page où le focus clavier reste bloqué : les utilisateurs peuvent entrer avec Tab dans un élément (un [lecteur vidéo](https://allyway.ai/fr/glossary/lecteur-video-accessible) intégré, une carte, un widget de chat, une boîte de dialogue défectueuse), mais aucune touche ne les en fait sortir. Pour une personne qui ne peut pas utiliser de souris, le reste de la page devient inaccessible, et la seule issue consiste souvent à fermer l’onglet.

## Ce que cela signifie

[WCAG 2.1.2 Pas de piège au clavier](https://www.w3.org/WAI/WCAG22/Understanding/no-keyboard-trap.html) est un critère de niveau A des [WCAG 2.2](https://allyway.ai/fr/regulations/wcag-2-2). Il exige que, si le focus peut être déplacé vers un composant avec le clavier, il puisse aussi en être retiré avec le clavier seul. Si la sortie demande plus que les touches fléchées ou Tab non modifiées, ou qu’une autre méthode de sortie standard, les utilisateurs doivent être informés de la méthode. Par l’article 9.2.1.2 de la [norme EN 301 549](https://allyway.ai/fr/regulations/en-301-549), ce critère s’applique aussi dans le cadre de l’[acte européen sur l’accessibilité](https://allyway.ai/fr/regulations/eaa).

Ce critère a un statut particulier. Comme un piège peut rendre toute la page inutilisable, les WCAG le classent parmi les exigences que *tout* le contenu d’une page doit respecter, même les widgets tiers sur lesquels vous ne vous appuyez pour satisfaire aucun autre critère.

Une restriction du focus n’est pas forcément un piège. Le W3C autorise explicitement à maintenir le focus dans une [boîte de dialogue modale](https://allyway.ai/fr/glossary/boite-de-dialogue-modale-accessible), tant que les utilisateurs peuvent la fermer :

| Situation | Verdict |
|---|---|
| **Boîte de dialogue modale** – Tab circule à l’intérieur, Échap ou « Fermer » y met fin | Autorisé |
| **Éditeur de texte enrichi** – Tab crée un retrait, une indication à l’écran donne la touche de sortie | Autorisé (les utilisateurs sont informés) |
| **Lecteur intégré** – Tab et Échap sont sans effet, aucune indication | **Piège au clavier** – échec au critère 2.1.2 |
| **Widget personnalisé** qui intercepte toutes les touches | **Piège au clavier** – échec au critère 2.1.2 |

> **Note:** > **Piège à focus voulu ou piège au clavier**
> Les développeurs parlent de « focus trap » (piège à focus) pour le modèle volontaire des boîtes de dialogue modales. Il ne devient un piège au clavier au sens des WCAG que s’il n’existe aucun moyen d’en sortir au clavier.

## Exemples

```html title="Exemple"
<!-- Keyboard trap: Tab is caught and Esc is ignored -->
<div class="widget" tabindex="0" onkeydown="event.preventDefault()">…</div>

<!-- Accessible modal: focus stays inside, Esc and the button close it -->
<dialog id="newsletter" aria-labelledby="nl-title">
  <h2 id="nl-title">Get our newsletter</h2>
  <label for="nl-mail">Email</label>
  <input id="nl-mail" type="email">
  <button type="button" onclick="this.closest('dialog').close()">Close</button>
</dialog>
<script>document.getElementById('newsletter').showModal();</script>
```

Un élément `<dialog>` natif ouvert avec `showModal()` se ferme par défaut avec Échap. Après la fermeture, rendez le focus au bouton qui a ouvert la boîte de dialogue, pour que les utilisateurs reprennent là où ils s’étaient arrêtés.

**Do:** À faire

Permettez de fermer les boîtes de dialogue et les menus avec Échap, rendez le focus au déclencheur après la fermeture, donnez aux lecteurs et aux cartes intégrés une sortie clavier claire, et expliquez à l’écran toute touche de sortie non standard.

**Don't:** À éviter

Appeler `preventDefault()` sur chaque événement keydown, intégrer des widgets tiers sans les tester au clavier, ou ouvrir une fenêtre modale dépourvue de bouton de fermeture.

Un piège apparaît généralement lors d’un test général de [navigation au clavier](https://allyway.ai/fr/glossary/navigation-au-clavier). Testez avec un indicateur de focus visible : sans [visibilité du focus](https://allyway.ai/fr/glossary/visibilite-du-focus), il est difficile de savoir si le focus est bloqué ou simplement invisible.

## Comment repérer un piège au clavier



## Questions fréquentes

Q: Qu’est-ce qu’un piège au clavier ?
A: Une partie de page dans laquelle le focus clavier peut entrer, mais dont il ne peut pas sortir au clavier. Le critère WCAG 2.1.2 Pas de piège au clavier (niveau A) l’interdit.

Q: Un piège à focus dans une fenêtre modale est-il contraire aux WCAG ?
A: Non. Garder le focus dans une fenêtre modale ouverte est le comportement attendu, à condition que les utilisateurs puissent la fermer au clavier, par exemple avec Échap ou un bouton Fermer.

Q: Quelles touches comptent comme méthodes de sortie standard ?
A: Les WCAG citent les touches Tab et fléchées non modifiées. Échap est une sortie standard courante sur les claviers physiques. Si votre widget nécessite une autre touche, comme Alt+F10, indiquez-le aux utilisateurs à l’écran.

Q: Les contenus tiers intégrés sont-ils concernés par le critère WCAG 2.1.2 ?
A: Oui. Un piège au clavier, où qu’il se trouve, bloque toute la page : les WCAG exigent donc que tout le contenu respecte le critère 2.1.2, y compris les lecteurs intégrés, les cartes et les widgets de chat.

Q: Comment détecter un piège au clavier sur mon site ?
A: Parcourez chaque modèle de page et chaque widget avec Tab, sans souris. Pour repérer aussi sur tout votre site des problèmes voisins, comme des contrôles sans rôle ni nom, lancez le [vérificateur WCAG gratuit](https://allyway.ai/fr/free-wcag-accessibility-scanner-for-websites).
