Scan gratuit

12 novembre 2026

Modale accessible : le motif de dialogue modal du W3C pas à pas

Une modale accessible est une fenêtre de dialogue superposée à la page, dont le contenu sous-jacent devient inerte, et qui reste utilisable au clavier comme avec une technologie d'assistance. Le guide des pratiques ARIA du W3C (APG) décrit précisément son comportement : à l'ouverture, le focus se place dans la fenêtre ; Tab et Maj+Tab ne permettent pas d'en sortir ; la touche Échap la ferme ; à la fermeture, le focus revient sur l'élément qui l'a ouverte. Côté code, le conteneur porte le rôle dialog, l'attribut aria-modal="true" et un nom accessible. Ce guide reprend ces recommandations une à une, avec les nuances que le W3C apporte sur le placement du focus et sur l'usage d'aria-modal, puis propose un exemple de code que vous pouvez adapter.

Qu'est-ce qu'une modale accessible selon le W3C ?

Pour l'APG, un dialogue est une fenêtre superposée à la fenêtre principale ou à une autre fenêtre de dialogue. Ce qui le rend modal, c'est que les fenêtres situées en dessous sont inertes : l'utilisateur ne peut pas interagir avec le contenu extérieur au dialogue actif.

Ce contenu inerte est généralement masqué visuellement ou assombri pour être difficile à distinguer. Dans certaines implémentations, toute tentative d'interagir avec lui ferme le dialogue.

Comme les dialogues non modaux, les dialogues modaux contiennent leur propre séquence de tabulation. En revanche, contrairement à la plupart des dialogues non modaux, une modale n'offre aucun moyen de déplacer le focus clavier hors de la fenêtre sans la fermer. Pour un message bref et important destiné à capter l'attention, le W3C prévoit un cas particulier, le rôle alertdialog, décrit dans un motif à part : l'Alert Dialog Pattern.

Focus à l'ouverture : où le placer dans la modale ?

Règle de base : quand un dialogue s'ouvre, le focus se déplace vers un élément contenu dans le dialogue. En général, c'est le premier élément focalisable. Mais l'APG précise que le meilleur emplacement dépend de la nature et de la taille du contenu, et donne plusieurs cas :

Piège du focus dans la modale : Tab, Maj+Tab et Échap

L'APG appelle « élément tabulable » tout élément dont la valeur de tabindex est supérieure ou égale à zéro, et précise que les valeurs supérieures à 0 sont fortement déconseillées. Une fois le dialogue ouvert, le clavier doit se comporter ainsi :

<button type="button" id="open-dialog">Supprimer le compte</button>

<div id="dialog" role="dialog" aria-modal="true"
     aria-labelledby="dialog-title" aria-describedby="dialog-desc" hidden>
  <h2 id="dialog-title">Supprimer le compte ?</h2>
  <p id="dialog-desc">Cette action est définitive.</p>
  <button type="button" id="cancel">Annuler</button>
  <button type="button" id="confirm">Supprimer</button>
</div>

<script>
const dialog = document.getElementById('dialog');
const cancel = document.getElementById('cancel');
let opener = null;

function tabbables() {
  return [...dialog.querySelectorAll('a[href], button, input, select, textarea, [tabindex]')]
    .filter(el => !el.disabled && el.tabIndex >= 0);
}

function openDialog(event) {
  opener = event.currentTarget;   // mémorise l'élément déclencheur
  dialog.hidden = false;
  // Condition pour garder aria-modal="true" : le reste de la page doit devenir
  // inerte pour tous les utilisateurs ET être masqué visuellement (non montré ici).
  cancel.focus();                 // action la moins destructrice
}

function closeDialog() {
  dialog.hidden = true;
  if (opener && opener.isConnected) opener.focus(); // retour du focus
  else document.querySelector('main h1')?.focus(); // repli : un élément logique (à adapter, tabindex="-1" si besoin)
}

dialog.addEventListener('keydown', (e) => {
  if (e.key === 'Escape') { closeDialog(); return; }
  if (e.key !== 'Tab') return;
  const items = tabbables();
  const first = items[0], last = items[items.length - 1];
  if (e.shiftKey && document.activeElement === first) { e.preventDefault(); last.focus(); }
  else if (!e.shiftKey && document.activeElement === last) { e.preventDefault(); first.focus(); }
});

document.getElementById('open-dialog').addEventListener('click', openDialog);
cancel.addEventListener('click', closeDialog);
</script>

Fermeture de la modale : où renvoyer le focus ?

Quand le dialogue se ferme, le focus revient sur l'élément qui l'a ouvert. L'APG prévoit deux exceptions. La première : l'élément déclencheur n'existe plus ; le focus va alors sur un autre élément qui assure un enchaînement logique. La seconde : la conception du parcours comporte des conditions qui rendent parfois plus logique de focaliser un autre élément, à savoir lorsqu'il est très peu probable que l'utilisateur ait besoin de rouvrir aussitôt le dialogue, et lorsque la tâche accomplie dans le dialogue est directement liée à l'étape suivante.

L'exemple donné par le W3C : une grille possède une barre d'outils avec un bouton d'ajout de lignes. Ce bouton « Add Rows » ouvre un dialogue qui demande le nombre de lignes. À la fermeture, le focus est placé dans la première cellule de la première nouvelle ligne.

Enfin, il est fortement recommandé que la séquence de tabulation de tout dialogue contienne un élément visible ayant le rôle button qui ferme le dialogue, comme une icône de fermeture ou un bouton Annuler.

Rôles et attributs ARIA d'une modale accessible

Le motif du W3C fixe les rôles, états et propriétés suivants :

aria-modal ou aria-hidden : les précautions du W3C

Déclarer un dialogue modal avec aria-modal="true" peut empêcher les utilisateurs de certaines technologies d'assistance de percevoir le contenu situé hors du dialogue. Si le dialogue est marqué modal sans se comporter comme tel pour les autres utilisateurs, les conséquences sont graves pour les utilisateurs de ces technologies d'assistance. L'APG demande donc de ne marquer un dialogue modal que si deux conditions sont réunies : le code de l'application empêche tous les utilisateurs d'interagir de quelque manière que ce soit avec le contenu extérieur, et le style visuel masque ce contenu.

La propriété aria-modal, introduite par ARIA 1.1, remplace aria-hidden pour indiquer aux technologies d'assistance que le contenu hors du dialogue est inerte. Dans les implémentations anciennes qui utilisent encore aria-hidden à cette fin, deux points sont importants :

Liste de contrôle pour tester votre modale accessible

Pour vérifier une modale existante, reprenez les points du motif W3C un par un, au clavier seul puis avec un lecteur d'écran. Le W3C propose aussi deux exemples de référence : un exemple de dialogue modal qui montre plusieurs couches de dialogues avec peu ou beaucoup de contenu, et un exemple de sélecteur de date avec une grille de calendrier.

Questions fréquentes

Comment rendre une fenêtre modale accessible ?

Selon le W3C, placez le focus dans la fenêtre à l'ouverture, faites boucler Tab et Maj+Tab à l'intérieur, fermez-la avec Échap et renvoyez le focus sur l'élément déclencheur à la fermeture. Le conteneur porte role="dialog", aria-modal="true" et un nom accessible via aria-labelledby ou aria-label.

Quel rôle ARIA utiliser pour une modale ?

Le rôle dialog sur le conteneur. Pour un message bref et important qui doit détourner l'attention de l'utilisateur, le W3C prévoit le rôle alertdialog, décrit dans l'Alert Dialog Pattern.

Où mettre le focus à l'ouverture d'une modale ?

En général sur le premier élément focalisable. Si le contenu est structuré ou long, il est conseillé de focaliser un élément statique doté de tabindex="-1", au début du contenu ou en haut du dialogue (titre, premier paragraphe). Avant une action difficilement réversible, il peut être judicieux de placer le focus sur l'action la moins destructrice.

La touche Échap doit-elle fermer une modale ?

Oui. Dans le motif de dialogue modal du W3C, la touche Échap ferme le dialogue. Il est aussi fortement recommandé de prévoir un bouton de fermeture visible dans la séquence de tabulation.

Faut-il utiliser aria-modal ou aria-hidden ?

aria-modal, introduit par ARIA 1.1, remplace aria-hidden pour signaler que le contenu extérieur est inerte. Ne marquez un dialogue modal que si le code empêche tous les utilisateurs d'interagir avec le contenu extérieur et que le style visuel masque ce contenu. Dans les implémentations anciennes qui utilisent aria-hidden, définissez aria-hidden="true" sur chaque élément de la couche inerte, et veillez à ce que le dialogue ne soit descendant d'aucun élément ayant aria-hidden="true".

Où revient le focus quand on ferme une modale ?

Sur l'élément qui l'a ouverte. S'il n'existe plus, le focus va sur un autre élément qui assure un enchaînement logique. Si le parcours le justifie (réouverture immédiate très improbable, tâche directement liée à l'étape suivante), un autre élément peut aussi être plus pertinent.

À lire aussi sur Conformly

Sources

Article appuyé sur les sources officielles citées en fin de page.