ARIA : attribut aria-description

L'attribut globalaria-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'utiliseraria-describedby, qui est pris en charge depuis ARIA 1.1.

Description

L'attribut globalaria-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.

html

<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'attributaria-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ésaria-description etaria-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ôtaria-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'attributaria-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 pararia-description ouaria-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ôtaria-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.