Element : propriété ariaModal
Baseline
Large disponibilité
Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis octobre 2023.
La propriété ariaModal de l'interface Element reflète la valeur de l'attribut aria-modal, qui indique si un élément est une fenêtre bloquante (modal en anglais) lorsqu'il est affiché. L'application de la propriété aria-modal à un élément avec role="dialog" remplace la technique consistant à utiliser aria-hidden sur l'arrière-plan pour informer les technologies d'assistance que le contenu en dehors d'une boîte de dialogue est inerte.
Valeur
Une chaîne de caractères contenant l'une des valeurs suivantes :
Exemples
Dans cet exemple, l'attribut aria-modal sur l'élément avec un ID de fenetre-adresse est défini sur "true", indiquant qu'il s'agit d'une boîte de dialogue bloquante. En utilisant ariaModal, nous mettons à jour la valeur à "false".
<div
role="dialog"
id="fenetre-adresse"
aria-labelledby="titreDialogue1"
aria-describedby="descriptionDialogue1"
aria-modal="true"></div>
let el = document.getElementById("fenetre-adresse");
console.log(el.ariaModal); // "true"
el.ariaModal = "false";
console.log(el.ariaModal); // "false"
Spécifications
| Spécification |
|---|
| Accessible Rich Internet Applications (WAI-ARIA) # dom-ariamixin-ariamodal |