Element : propriété role
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é role de l'interface Element retourne le rôle WAI-ARIA explicitement défini pour l'élément.
Tous les éléments HTML ont un rôle ARIA implicite, même si ce rôle est generic. Cette association sémantique permet aux outils de présenter et de prendre en charge l'interaction avec l'objet d'une manière cohérente avec les attentes des utilisateur·ice·s concernant d'autres objets de ce type. L'attribut role est utilisé pour définir explicitement le rôle ARIA de l'élément, remplaçant le rôle implicite. Par exemple, un <ul>, qui a un rôle list implicite, peut avoir role="treegrid" défini explicitement. La propriété role reflète la valeur explicitement définie de l'attribut role — dans ce cas treegrid ; elle ne retourne pas le rôle list implicite de l'élément sauf si celui-ci est défini explicitement.
La liste complète des rôles ARIA définis se trouve sur la page de référence des rôles ARIA.
Valeur
Une chaîne de caractères ; la valeur de l'attribut role ou null si elle n'est pas définie explicitement.
Exemples
Dans cet exemple, les images avec des attributs alt vides ou manquants se voient attribuer un role de presentation :
const images = document.querySelectorAll("img");
images.forEach((image) => {
if (!image.alt) {
image.role = "presentation";
}
});
Spécifications
| Spécification |
|---|
| Accessible Rich Internet Applications (WAI-ARIA) # dom-ariamixin-role |
Compatibilité des navigateurs
Voir aussi
- La propriété
ElementInternals.role - Les attributs ARIA