ARIA : attribut aria-description
L'attribut global aria-description
définit une valeur textuelle qui décrit ou annote l'élément courant.
Note :
aria-description
est encore à l'état de brouillon dans la spécification W3C ARIA 1.3. Pour l'instant, continuez d'utiliser aria-describedby
, qui est pris en charge depuis ARIA 1.1.
Description
L'attribut global aria-description
permet au développeur ou à la développeuse de décrire ou d'annoter l'élément courant afin de fournir un contexte supplémentaire aux utilisateur·ice·s de technologies d'assistance.
<div
role="application"
aria-label="calendrier"
aria-description="Calendrier des matchs des Boston Red Sox saison 2021">
<h1>Red Sox 2021</h1>
<div role="grid">…</div>
</div>
L'attribut aria-description
est similaire à aria-label
: les deux fournissent une chaîne de texte associée à l'élément, mais un libellé doit être court et concis, tandis qu'une description peut être plus longue car elle vise à fournir davantage de contexte et d'informations.
Les propriétés aria-description
et aria-describedby
ont le même objectif : fournir à l'utilisateur·ice un texte descriptif supplémentaire pour l'objet sur lequel elles sont définies. Si un texte descriptif est disponible dans le DOM, utilisez plutôt aria-describedby
.
La propriété aria-description
ne doit être utilisée que si fournir une description visible n'est pas l'expérience utilisateur souhaitée. L'attribut aria-describedby
prend comme valeur une liste d'id
des éléments contenant le texte descriptif de l'objet. aria-description
s'utilise lorsqu'aucun texte descriptif approprié ne peut être associé à l'objet par référence d'id
. Si les deux attributs sont présents, aria-describedby
prévaut pour définir la propriété description accessible.
Le contenu de la description, qu'il soit défini par aria-description
ou aria-describedby
, doit être du texte simple. Si le contenu est très long, possède une sémantique particulière ou une structure de navigation, utilisez plutôt aria-details
.
Valeurs
<string>
-
La valeur est une chaîne de caractères, de type libre, destinée à être transmise à l'utilisateur·ice de technologies d'assistance.
Interfaces associées
Element.ariaDescription
-
La propriété
ariaDescription
, qui fait partie de l'interfaceElement
, reflète la valeur de l'attributaria-description
, qui définit une valeur textuelle décrivant ou annotant l'élément courant.
Rôles associés
Utilisé dans TOUS les rôles.
Spécifications
Specification |
---|
Accessible Rich Internet Applications (WAI-ARIA)> # aria-description> |
Voir aussi
- Attribut HTML
title
- L'attribut ARIA
aria-describedby
- L'attribut ARIA
aria-details