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> |