# Boîte de dialogue modale accessible : focus, Échap, ARIA

Source: https://allyway.ai/fr/glossary/boite-de-dialogue-modale-accessible

Une boîte de dialogue modale accessible est une fenêtre contextuelle que les utilisateurs du clavier et des lecteurs d’écran peuvent utiliser comme tout le monde : le focus y entre à l’ouverture, la page en arrière-plan est inerte, la touche Échap la ferme et le focus revient à la commande qui l’a ouverte. Sa gestion du focus relève du critère WCAG 2.4.3 Parcours du focus, de niveau A.

Une boîte de dialogue modale accessible est une fenêtre contextuelle (fenêtre de connexion, invitation à la newsletter, « aperçu rapide » dans une boutique) qui fonctionne aussi pour les personnes qui n’utilisent pas la souris. Beaucoup de boîtes de dialogue s’ouvrent à l’écran mais laissent le focus clavier sur la page en arrière-plan : les utilisateurs du clavier parcourent alors des liens masqués pendant que la boîte attend au premier plan, et les utilisateurs de lecteurs d’écran ne savent jamais qu’elle est apparue. Bien gérer le focus, c’est l’essentiel du travail.

## Ce que cela signifie

Une boîte de dialogue modale prend le contrôle de la page jusqu’à sa fermeture. Le W3C en fait un exemple pour le critère [WCAG 2.4.3 Parcours du focus](https://www.w3.org/WAI/WCAG22/Understanding/focus-order.html) (niveau A) : quand on active le bouton déclencheur, la boîte s’ouvre et le focus s’y place ; tant qu’elle est ouverte, le contenu extérieur est inerte et ne peut pas recevoir le focus ; quand on la ferme, le focus revient au bouton déclencheur ou à l’élément qui le suit. Le W3C recense l’élément HTML `dialog` comme technique H102, et le cas d’échec F85 décrit les boîtes de dialogue qui ne se trouvent pas à côté de leur déclencheur dans l’ordre de navigation.

Le [modèle de boîte de dialogue modale](https://www.w3.org/WAI/ARIA/apg/patterns/dialog-modal/) des WAI-ARIA Authoring Practices ajoute le comportement clavier et le balisage attendus :

| Élément | Comportement attendu |
|---|---|
| Ouverture | Le focus se place sur un élément à l’intérieur de la boîte, en général le premier élément pouvant le recevoir |
| Tab / Maj+Tab | Le focus circule à l’intérieur de la boîte et revient du dernier élément au premier |
| Échap | Ferme la boîte de dialogue |
| Fermeture | Le focus revient à l’élément qui l’a ouverte |
| `role="dialog"` | Sur le conteneur ; `alertdialog` pour les messages brefs et urgents |
| `aria-modal="true"` | Indique aux technologies d’assistance que le contenu en arrière-plan est inerte |
| `aria-labelledby` | Pointe vers le titre visible de la boîte, ce qui lui donne un [nom accessible](https://allyway.ai/fr/glossary/nom-accessible) |

> **Note:** > **Retenir le focus n’est pas un piège au clavier**
> Que la touche Tab reste à l’intérieur d’une boîte ouverte est voulu. Cela ne devient un [piège au clavier](https://allyway.ai/fr/glossary/piege-au-clavier) que si l’on ne peut pas en sortir : c’est pourquoi la touche Échap et un bouton de fermeture visible comptent.

## Exemples

L’élément natif `dialog` gère l’essentiel pour vous lorsqu’on l’ouvre avec `showModal()` :

```html title="Exemple"
<button type="button" id="open">Sign up for our newsletter</button>

<dialog id="newsletter" aria-labelledby="nl-title">
  <h2 id="nl-title">Newsletter</h2>
  <form method="dialog">
    <label for="nl-email">Email address</label>
    <input id="nl-email" type="email" autocomplete="email">
    <button value="ok">Subscribe</button>
    <button value="cancel">Close</button>
  </form>
</dialog>

<script>
  const dialog = document.getElementById('newsletter');
  const opener = document.getElementById('open');
  opener.addEventListener('click', () => dialog.showModal());
  dialog.addEventListener('close', () => opener.focus());
</script>
```

`showModal()` rend le reste de la page inerte, place le focus dans la boîte et la ferme avec Échap. L’écouteur `close` rend le focus au bouton, comme le décrit le W3C. Si vous construisez une boîte de dialogue à partir d’une `div`, vous devez gérer vous-même `role="dialog"`, `aria-modal="true"`, la boucle de focus et la touche Échap : voir [ARIA](https://allyway.ai/fr/glossary/aria) pour la règle qui consiste à préférer le HTML natif.

**Do:** À faire

Déplacez le focus dans la boîte, donnez-lui un titre visible relié par `aria-labelledby`, fermez-la avec Échap et un bouton de fermeture muni d’un intitulé, gardez la page en arrière-plan inerte et rendez le focus au déclencheur.

**Don't:** À éviter

Ouvrir une boîte de dialogue sans déplacer le focus, laisser Tab s’égarer vers la page en arrière-plan, utiliser un bouton de fermeture réduit à une icône et sans nom, l’ouvrir automatiquement au chargement de la page, ou laisser le focus en haut de la page après la fermeture.

## Comment vérifier une boîte de dialogue modale accessible



## Questions fréquentes

Q: Qu’est-ce qui rend une boîte de dialogue modale accessible ?
A: Le focus y entre à l’ouverture, la page en arrière-plan est inerte, Tab reste à l’intérieur, Échap la ferme et le focus revient ensuite au déclencheur. Il lui faut aussi un titre visible qui la nomme pour les lecteurs d’écran.

Q: Faut-il utiliser l’élément HTML dialog ou ARIA ?
A: Préférez l’élément natif `dialog` ouvert avec `showModal()` : le W3C le recense comme technique H102 pour le critère WCAG 2.4.3. Ne construisez une boîte personnalisée à partir d’une `div`, avec `role="dialog"` et `aria-modal="true"`, que si vous ne pouvez pas utiliser l’élément natif.

Q: Où le focus doit-il aller à l’ouverture d’une boîte de dialogue ?
A: Selon les WAI-ARIA Authoring Practices, en général sur le premier élément pouvant le recevoir à l’intérieur. Pour un contenu long, le titre ou le début du contenu peut être une meilleure cible, afin que les utilisateurs ne manquent pas ce qui vient en premier.

Q: Est-il permis de retenir le focus dans une boîte modale ?
A: Oui, tant que la boîte est ouverte. L’exemple du W3C pour le critère 2.4.3 rend le contenu extérieur inerte. Il doit toutefois être facile d’en sortir : la touche Échap et un bouton de fermeture muni d’un intitulé évitent qu’elle ne devienne un piège au clavier.

Q: Quels critères WCAG s’appliquent aux boîtes de dialogue modales ?
A: Principalement 2.4.3 Parcours du focus et 2.1.1 Clavier, ainsi que 4.1.2 Nom, rôle et valeur pour le rôle et le nom de la boîte, et 2.1.2 Pas de piège au clavier. Tous sont de niveau A dans les [WCAG 2.2](https://allyway.ai/fr/regulations/wcag-2-2).
