Attribut global HTMLAttributs globaux

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
Sur cette page

Exemple

#
HTML
<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>
Aperçu

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

#
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 aussi tabindex="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 pour banner.
  • 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 dans aria-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 avec list-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 attributs aria-selected et aria-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

#
Un message d’état lu par un lecteur d’écran
HTML
<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>
Aperçu

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" ou role="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

#

Pratiquer dans les leçons

#

Vous voyez une erreur ou il manque un exemple ? Écrivez-nous.