CKTIS / HTML
aria-modal — sémantique des dialogues modaux
L’attribut aria-modal indique aux technologies d’assistance si un élément affiché est modal, c’est-à-dire si l’interaction est limitée à son contenu. À lui seul, il ne bloque pas l’arrière-plan et ne gère pas le focus : la déclaration doit correspondre au comportement réel de l’interface.
Version : WHATWG HTML Living Standard; index snapshot date recorded separately
Syntaxe
aria-modal="true" | aria-modal="false"aria-modal est une propriété WAI-ARIA utilisée en HTML pour indiquer si un élément affiché est modal. La valeur true indique la modalité ; false est la valeur par défaut. Cette propriété prend les valeurs textuelles true et false et ne suit pas la syntaxe des attributs booléens HTML : n’écrivez pas le nom de l’attribut sans valeur. Elle est prise en charge pour les rôles dialog et alertdialog, mais pas globalement sur des éléments arbitraires.
aria-modal="true" communique une sémantique aux technologies d’assistance, qui peuvent limiter la navigation au contenu du dialogue. Cela n’ouvre pas de dialogue, ne bloque pas les clics sur l’arrière-plan et ne déplace ni ne maintient le focus. Utilisez cette valeur uniquement lorsque l’interface empêche réellement tout le monde d’interagir avec le contenu extérieur au dialogue et que l’arrière-plan est visuellement assombri ou masqué.
À l’ouverture, déplacez le focus dans le dialogue et maintenez-y la séquence Tab et Shift+Tab. Prévoyez un bouton de fermeture à l’intérieur et la prise en charge de Escape ; à la fermeture, restaurez généralement le focus sur l’élément déclencheur. Donnez au dialogue un nom accessible, par exemple avec aria-labelledby faisant référence à son titre visible. Tous les contrôles nécessaires à l’utilisation du dialogue doivent en être des descendants.
L’exemple utilise un dialogue natif ouvert avec showModal() au lieu de recréer manuellement le comportement modal. Dans ce cas, aria-modal="true" est redondant, car la modalité native est déjà exposée aux technologies d’assistance ; il est conservé pour illustrer la syntaxe. Ajouter cet attribut seul à un conteneur ordinaire ne fournit pas ce comportement. Vérifiez séparément le fonctionnement au clavier et la sémantique dans l’arbre d’accessibilité.
Exemples
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>aria-modal example</title>
<style>
dialog::backdrop { background: rgb(0 0 0 / 50%); }
</style>
<button id="open" type="button">Open dialog</button>
<dialog id="notice" aria-modal="true" aria-labelledby="heading">
<h2 id="heading">Notice</h2>
<p>This dialog blocks interaction with the page.</p>
<button id="close" type="button" autofocus>Close</button>
</dialog>
<script>
const opener = document.getElementById('open');
const notice = document.getElementById('notice');
const closer = document.getElementById('close');
opener.addEventListener('click', () => notice.showModal());
closer.addEventListener('click', () => notice.close());
notice.addEventListener('close', () => opener.focus());
</script>
</html>Résultat
Initially, only Open dialog is visible. Activating it opens Notice, dims the background, and focuses Close. Background controls cannot be activated while the dialog is open. Close or Escape dismisses the dialog and returns focus to Open dialog.
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.