Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.

View in English Always switch to English

ARIA : rôles structurels de document

Les rôles ARIA de structure de document servent à fournir une description structurelle d'une section de contenu.

Les rôles ARIA structurels ont été créés à l'origine comme un pont pour informer les technologies d'assistance de l'existence d'éléments HTML5 qui n'étaient pas encore pleinement pris en charge par les navigateurs. Certains rôles, comme presentation, toolbar et tooltip, fournissent des informations sur la structure du document aux technologies d'assistance dans les cas où il n'existe pas d'élément HTML natif équivalent. D'autres rôles, dont ceux listés dans le tableau ci-dessous, ne sont pas nécessaires, car il existe des éléments HTML sémantiques ayant la même signification. Dans de nombreux cas, ces éléments HTML équivalents ont toujours été pris en charge.

Attention : Tous ces rôles structurels possèdent des équivalents HTML sémantiques. Ils sont inclus ici pour compléter la documentation. Il est préférable de ne pas les utiliser. Privilégiez les éléments HTML sémantiques.

Certains rôles structurels, comme suggestion, n'ont pas d'équivalent HTML et disposent donc d'une documentation séparée. D'autres rôles structurels ayant des équivalents HTML, comme heading, nécessitent des attributs ARIA. Ils sont listés ci-dessous avec des liens vers leur documentation individuelle.

La plupart des rôles suivants n'ont jamais été nécessaires, mais ont été ajoutés à ARIA pour des raisons d'exhaustivité. Nous les incluons ici pour la même raison.

Rôles structurels avec équivalents HTML

Les rôles de structure disposant d'équivalents HTML sont listés ci-dessous :

Rôle ARIA & description Équivalent HTML
associationlist
Contient uniquement des enfants associationlistitemkey et des enfants de même parents associationlistitemvalue.
<dl>
associationlistitemkey
Doit être contenu dans un associationlist.
<dt>
associationlistitemvalue
Toujours un enfant d'un même parent suivant un associationlistitemkey.
<dd>
blockquote
Une section de contenu citée d'une autre source.
<blockquote>
caption
Contenu visible qui nomme, et peut aussi décrire, une figure, table, grid ou treegrid.
Présent uniquement dans ces 4 rôles. L'id d'une légende est généralement référencé par l'attribut aria-labelledby d'une figure, grid, table ou treegrid.
Attributs interdits : aria-label et aria-labelledby.
<caption>
<figcaption>
code
Une section représentant un fragment de code informatique.
Attributs interdits : aria-label et aria-labelledby.
<code>
deletion
Contenu marqué comme supprimé ou suggéré à la suppression.
Attributs interdits : aria-label et aria-labelledby.
<del>
emphasis
Utilisé pour mettre en valeur ou accentuer un contenu, sans suggérer l'importance.
Attributs interdits : aria-label et aria-labelledby.
<em>
figure
Conteneur pour un document graphique, des images, des extraits de code ou du texte d'exemple.
<figure>
heading
Un titre pour une section de la page.
L'attribut aria-level est requis pour indiquer le niveau d'imbrication.
Voir le rôle heading pour plus d'informations.
h1, h2, h3, h4, h5, et h6
image
Conteneur pour un ensemble d'éléments formant une image. Synonyme du rôle img.
<img>
img
Conteneur pour un ensemble d'éléments formant une image.
Nom accessible requis.
Voir le rôle img pour plus d'informations.
<img>
insertion
Contenu marqué comme ajouté ou suggéré à l'ajout.
Attributs interdits : aria-label et aria-labelledby.
<ins>
list
Une section contenant des éléments listitem.
Voir le rôle list pour plus d'informations.
<ol>
<ul>
listitem
Un élément unique dans une list ou un directory.
Doit être contenu dans une list (comme <li>).
Voir le rôle listitem pour plus d'informations.
<li>
mark
Marqué ou mis en surbrillance à des fins de référence ou de notation.
Voir le rôle mark pour plus d'informations.
<mark>
meter
Une mesure scalaire dans une plage connue, ou une valeur fractionnaire.
Nom accessible requis. aria-valuenow requis.
Voir le rôle meter pour plus d'informations.
<meter>
paragraph
Un paragraphe de contenu.
Attributs interdits : aria-label et aria-labelledby.
<p>
strong
Contenu important, sérieux ou urgent.
Attributs interdits : aria-label et aria-labelledby.
<strong>
subscript
Un ou plusieurs caractères en indice.
À utiliser uniquement si l'absence du rôle change le sens du contenu.
Attributs interdits : aria-label et aria-labelledby.
<sub>
superscript
Un ou plusieurs caractères en exposant.
À utiliser uniquement si l'absence du rôle change le sens du contenu.
Attributs interdits : aria-label et aria-labelledby.
<sup>
term
Mot ou expression avec une définition optionnelle correspondante.
Attributs interdits : aria-label et aria-labelledby.
Voir le rôle term pour plus d'informations.
<dfn>
time
Une date ou une heure valide au format chaîne représentant un point précis dans le temps.
Attributs interdits : aria-label et aria-labelledby.
<time>

Note : Les attributs aria-label et aria-labelledby sont interdits sur code, caption, deletion, emphasis, generic, insertion, mark, paragraph, presentation, none, strong, subscript, superscript, suggestion, term et time, et ne doivent être utilisés que sur du contenu interactif.

Spécifications

Specification
Accessible Rich Internet Applications (WAI-ARIA)
# document_structure_roles