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 :
- Contenu structuré (listes, tableaux, plusieurs paragraphes) difficile à comprendre s'il est annoncé d'un seul bloc : il est conseillé d'ajouter tabindex="-1" à un élément statique au début du contenu et de lui donner le focus initial. Il est alors plus facile pour les utilisateurs de technologies d'assistance de lire le contenu en parcourant ses structures. Dans ce cas, il est aussi conseillé de ne pas mettre aria-describedby sur le conteneur.
- Contenu long, où focaliser le premier élément interactif ferait défiler le début hors de la vue : il est conseillé d'ajouter tabindex="-1" à un élément statique en haut du dialogue, comme le titre ou le premier paragraphe, et de le focaliser.
- Dernière étape d'un processus difficilement réversible (suppression de données, transaction financière) : il peut être judicieux de placer le focus sur l'action la moins destructrice. L'Alert Dialog Pattern est souvent employé dans ce cas.
- Dialogue limité à fournir une information ou à poursuivre un traitement : il peut être judicieux de placer le focus sur l'élément qui sera probablement le plus utilisé, comme un bouton OK ou Continuer.
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 :
- Tab : déplace le focus vers l'élément tabulable suivant à l'intérieur du dialogue. Depuis le dernier, le focus revient au premier.
- Maj+Tab : déplace le focus vers l'élément tabulable précédent à l'intérieur du dialogue. Depuis le premier, le focus va au dernier.
- Échap : ferme le dialogue.
<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 :
- Le conteneur du dialogue a le rôle dialog.
- Tous les éléments nécessaires pour utiliser le dialogue sont des descendants de l'élément qui porte le rôle dialog.
- Le conteneur a aria-modal défini à true.
- Le dialogue a soit un aria-labelledby qui pointe vers un titre de dialogue visible, soit un libellé fourni par aria-label.
- Facultatif : aria-describedby, posé sur l'élément de rôle dialog, indique le ou les éléments qui décrivent l'objet principal ou le message du dialogue. Les lecteurs d'écran peuvent alors annoncer cette description avec le titre et l'élément focalisé à l'ouverture. Ce n'est généralement utile que si la description est simple et compréhensible sans information structurelle ; il est conseillé de l'omettre si le contenu comporte des listes, des tableaux ou plusieurs paragraphes difficiles à comprendre lus d'un seul bloc.
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 :
- aria-hidden est défini à true sur chaque élément contenant une partie de la couche inerte ;
- l'élément du dialogue n'est descendant d'aucun élément ayant aria-hidden à true.
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.
- À l'ouverture, le focus est-il bien dans le dialogue, à l'endroit adapté au contenu ?
- Tab et Maj+Tab bouclent-ils sans jamais sortir du dialogue ?
- Échap ferme-t-il le dialogue ?
- À la fermeture, le focus revient-il sur l'élément déclencheur ou, si l'élément déclencheur n'existe plus, sur un autre élément logique ?
- Un bouton de fermeture visible est-il présent dans la séquence de tabulation ?
- Le conteneur a-t-il role="dialog", aria-modal="true" et un nom via aria-labelledby ou aria-label ?
- Le contenu extérieur est-il réellement inerte pour tous et masqué visuellement ?
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.