Unedescription accessible (accessible description en anglais) est la description d'un élément d'interface utilisateur qui fournit des informations supplémentaires pour aider les utilisateur·ice·s de technologies d'assistance à comprendre l'élément UI et son contexte. Elle est associée à un élément HTML ou SVG et donne aux utilisateur·ice·s un contexte supplémentaire sur son but au-delà de ce qui est fourni par lenom accessible de l'élément. C'est particulièrement important pour les utilisateur·ice·s qui se servent de technologies d'assistance telles quelecteurs d'écrans. La description accessible d'un élément fait partie del'arbre d'accessibilité.

Par exemple, le nom accessible d'un tableau (<table>) est fourni par sa première légende (<caption>). Dans le cas de tableaux de données complexes, une ou deux phrases décrivant le tableau peuvent fournir une description. Cela peut être un paragraphe juste avant ou après le tableau, tant visuellement que dans l'ordre du code source. S'il se trouve ailleurs dans l'ordre source, ou pour rendre l'association explicite, l'attributaria-describedby peut être utilisé pour associer le tableau à sa description.

De même, lorsqu'un·e utilisateur·ice doit créer un mot de passe, le<label> pour l'élément HTML<input> de typepassword fournit son nom accessible. Une bonne description accessible inclut les exigences du mot de passe de manière visible pour tous les utilisateur·ice·s. Elle peut être explicitement associée à l'entrée via son attributaria-describedby, qui l'ajoute à l'arbre d'accessibilité en tant que « description » pour ce nœud.

Les descriptions sont réduites à des chaînes de texte. Dans notre exemple de mot de passe, si la valeur de l'attributaria-describedby de l'entrée est l'id d'un élément de liste non ordonnée (<ul>) contenant une liste de conditions, la description est le texte concaténé et les équivalents texte de tous les éléments de la liste.

Vous pouvez inspecter la description accessible de tout élément sur votre page : consultez l'onglet d'accessibilité des outils de développement de votre navigateur, qui fournit les informations d'accessibilité pour l'élément actuellement sélectionné.

Calcul de la description accessible

Pour les éléments HTML, s'il n'a pas de description accessible, celle‑ci doit être associée de façon programmatique à l'élément lié. Le modèle d'objet d'accessibilité (AOM) calcule la description accessible en vérifiant ces caractéristiques, dans l'ordre, jusqu'à ce qu'elle soit définie :

1. l'attributaria-describedby.
2. l'attributaria-description.
3. Les caractéristiques spécifiques à la langue qui participent au calcul de la description si la caractéristique n'est pas déjà utilisée pour définir lenom accessible. Par exemple :
   • Un<summary> est décrit par le contenu du<details> dans lequel il est imbriqué.
   • Les boutons<input> (avec l'attribut typebutton,submit oureset) sont décrits par la valeur de leur attributvalue.
   • En SVG, le contenu de l'élément<desc> est utilisé s'il est présent, sinon, le texte contenu dans les éléments descendants contenant du texte (c'est‑à‑dire<text>), s'ils ne sont pas déjà utilisés pour lenom accessible.
4. Si aucune des options précédentes ne fournit une description, l'attributtitle est utilisé, si letitle n'est pas lenom accessible de cet élément.
5. Si aucune des options précédentes ne définit une description accessible, la description accessible est vide.

Les étapes de définition de la description accessible en HTML sont décrites dans laDescription Accessible HTML-AAM^(angl.). La description accessible des éléments SVG suit les mêmes étapes avec de petites différences énumérées dans laDescription Accessible SVG-AAM^(angl.).

Voir aussi

• Calcul du nom et de la description accessibles 1.2 (accname)^(angl.)
• Accessibilité
• Apprendre l'accessibilité
• Accessibilité du Web sur Wikipedia
• Accessibilité Web en tête^(angl.)
• ARIA
• Initiative W3C pour l'accessibilité Web (WAI)^(angl.)
• Applications Riches d'Internet Accessible (WAI-ARIA)^(angl.)
• Termes associés du glossaire :
  • Accessibilité
  • Arbre d'accessibilité
  • Nom accessible
  • ARIA