string

aria-description

Fournit une description textuelle accessible à un élément, comme alternative inline à aria-describedby.

Description

aria-description fournit directement le texte de description dans l’attribut, sans nécessiter un élément DOM référencé par id. C’est l’équivalent direct de aria-label mais pour la description (comme aria-describedby est l’équivalent de aria-labelledby).

Introduit dans ARIA 1.3, il est utile quand une description courte est nécessaire mais qu’aucun élément visible dans le DOM ne peut jouer ce rôle.

Syntaxe

<button aria-description="Ouvre une nouvelle fenêtre de navigateur">
  Aide en ligne
</button>

Exemples

Bouton avec comportement non évident :

<button aria-label="Supprimer"
        aria-description="Supprime définitivement l'élément sans possibilité de récupération">
  🗑
</button>

Champ de formulaire avec contrainte :

<input type="text"
       aria-label="Identifiant"
       aria-description="6 à 20 caractères, lettres et chiffres uniquement" />

Notes

Préférer aria-describedby quand possible : si la description peut être visible dans le DOM, utiliser aria-describedby pour bénéficier à la fois aux utilisateurs AT et aux utilisateurs voyants.

Support limité : aria-description est récent (ARIA 1.3) et n’est pas encore universellement supporté. Vérifier le support avant utilisation en production.

Texte brut uniquement : comme aria-label, la valeur est du texte brut sans HTML.

Support navigateurs