role
Un rôle ARIA indique aux lecteurs d’écran ce qu’est un élément : un bouton, un onglet, un message, une navigation.
- S’applique à
- Tous les éléments HTML, bien que tous les rôles ne puissent pas être attribués à tous les éléments
Exemple
#<style>
.fake-button {
display: inline-block;
margin-top: 10px;
padding: 6px 12px;
border-radius: 6px;
background: #3f3f46;
cursor: pointer;
}
</style>
<button type="button" onclick="this.textContent = 'Progression enregistrée'">Enregistrer la progression (button)</button>
<br>
<div class="fake-button" role="button" tabindex="0" onclick="this.textContent = 'Progression enregistrée'">
Enregistrer la progression (div avec un rôle)
</div>Les deux éléments réagissent au clic de la souris. Atteignez-les maintenant avec la touche Tab et appuyez sur Entrée ou sur la barre d’espace : le <button> fonctionne, le <div role="button"> non, car un rôle n’ajoute pas la gestion du clavier.
Définition et utilisation
#L’attribut role attribue à un élément un rôle issu de la spécification WAI-ARIA. C’est une information destinée aux technologies d’assistance, comme les lecteurs d’écran : elle indique ce qu’est l’élément et ce qu’on peut en attendre. Avec role="button", le lecteur dira « bouton », et le contenu d’un élément avec role="alert" sera lu dès son apparition, même si l’utilisateur se trouve ailleurs dans la page.
La plupart des éléments HTML ont un rôle intégré : <button> est un bouton, <nav> une navigation, <a href> un lien et <ul> une liste. C’est pourquoi la première règle d’ARIA s’applique : s’il existe un élément HTML avec la signification et le comportement voulus, utilisez-le au lieu d’ajouter un rôle à un <div> ou un <span>. L’attribut role sert dans les situations où HTML n’a pas d’élément prêt à l’emploi, comme les onglets ou les messages annoncés en direct.
Un rôle ne change que la façon dont les technologies d’assistance perçoivent l’élément. Il ne change ni l’apparence ni le comportement : un <div role="button"> ne reçoit toujours pas le focus avec la touche Tab et ne réagit pas à Entrée ni à la barre d’espace, vous devez donc tout cela l’ajouter vous-même. Ne remplacez pas non plus les rôles sans nécessité. Un titre avec role="button" cesse d’être un titre, donc si un titre doit déplier quelque chose, placez-y un bouton.
Syntaxe
#<element role="nom-du-role">…</element>Les rôles les plus courants
#button
<button>
Un élément qui exécute une action. En dehors d’un élément<button>, il exige aussitabindex="0"et la gestion des touches Entrée et espace.link
<a href>
Un lien vers une autre page ou un endroit de la page. En dehors d’un élément<a>, il exige le focus et la gestion de la touche Entrée.navigation
<nav>
Un repère avec les liens principaux. Les lecteurs d’écran permettent d’y accéder rapidement.main
<main>
Le contenu principal de la page. Il ne devrait y avoir qu’une seule zone de ce type sur la page.banner
<header>
L’en-tête de toute la page. Un<header>a ce rôle uniquement lorsqu’il ne se trouve pas dans un<article>,<section>,<main>ou un élément similaire.contentinfo
<footer>
Le pied de page de toute la page avec les informations sur le site. La règle est la même que pourbanner.complementary
<aside>
Du contenu complémentaire, par exemple un panneau latéral avec des leçons recommandées.search
<search>
Une zone de recherche. On l’ajoutait autrefois à un formulaire, aujourd’hui c’est l’élément<search>qui l’a.img
<img>
Plusieurs éléments qui forment ensemble une seule image, par exemple un groupe d’icônes ou d’émojis. Il exige un nom, par exemple dansaria-label.list, listitem
<ul>, <ol>, <li>
Une liste et ses éléments. Ils rétablissent le sens de liste lorsque Safari cesse de les annoncer après la suppression des puces aveclist-style: none.alert
aucun
Un message urgent, par exemple une erreur de formulaire. Le lecteur interrompt généralement ce qu’il dit et le lit aussitôt. À utiliser avec parcimonie.status
<output>
Un message d’état, par exemple « Enregistré ». Le lecteur le lit une fois sa phrase en cours terminée.tablist, tab, tabpanel
aucun
Des onglets. Ils exigent la gestion des flèches ainsi que les attributsaria-selectedetaria-controls.presentation, none
aucun
Supprime la signification de l’élément, par exemple d’un tableau utilisé uniquement pour la mise en page. Ne fonctionne pas sur les éléments pouvant recevoir le focus.
Plus d’exemples
#<button type="button"
onclick="document.getElementById('cart-status').textContent = 'Formation ajoutée au panier'">
Ajouter au panier
</button>
<p id="cart-status" role="status"></p>L’élément vide avec role="status" est présent sur la page dès le départ. Lorsqu’un script y écrit du texte, le lecteur d’écran lit le message une fois sa phrase en cours terminée. Pour les erreurs urgentes, on utilise role="alert".
Compatibilité des navigateurs
#Largement disponible
Fonctionne dans tous les navigateurs modernes, y compris sur mobile. Vous pouvez l’utiliser sans crainte.
- Chrome
- Edge
- Firefox
- Safari
Bonnes pratiques
#- Avant d’ajouter un
role, vérifiez si le bon élément HTML ne suffit pas. Mieux vaut ne pas utiliser ARIA du tout que de l’utiliser mal. - Un rôle est une promesse. Si vous donnez
role="tab"ourole="menu", vous devez fournir la gestion du clavier qu’un utilisateur de lecteur d’écran attend d’onglets ou d’un menu. - Vous pouvez vérifier l’effet dans les outils de développement. Dans Chrome, le panneau Éléments possède un onglet Accessibilité qui indique le rôle et le nom de l’élément sélectionné.
Entrées associées
#- aria-*Les attributs ARIA décrivent les éléments pour les lecteurs d’écran : ils leur donnent des noms, les relient à des descriptions et signalent leur état.
- <button>Un bouton cliquable : il envoie un formulaire, le réinitialise, ou lance une action sur la page.
- <nav>Un bloc de liens de navigation principaux : menu, sommaire, fil d’Ariane.
- <main>Le contenu principal et unique de la page. Une seule instance visible par page.
- tabindexDétermine si un élément peut recevoir le focus avec la touche Tab et dans quel ordre.
Pratiquer dans les leçons
#Vous voyez une erreur ou il manque un exemple ? Écrivez-nous.