Rôle et attributs ARIA
Rôles et attributs ARIA générés par défaut
- Élément principal : <textarea>
- Attributs ARIA utilisés :
- aria-describedby : permet de fournir un texte descriptif comme un texte d’aide ou d’erreur
- aria-label : permet de fournir un nom accessible pour l’élément. Si le slot label est vide, c’est la valeur de accessible-name qui est utilisée
- aria-invalid="false" : passe à true si l’élément est en erreur (contenu non valide ou autre)
Attributs de l’élément ayant un impact sur l’accessibilité
|
Attribut |
Impact |
|---|---|
|
label |
⚠️ Obligatoire (ou son équivalent slot=”label”; sauf si accessible-name est utilisé, non recommandé) |
|
accessible-name |
⚠️ Déconseillé, préférer l’utilisation de label. |
|
help-text |
⚠️ Obligatoire si un format spécifique est attendu Ajoute un texte d’aide pour l’utilisateur, référencé par le aria-describedby. |
|
description |
Ajoute une description, référencée par le aria-describedby. |
|
disabled |
Ajoute les attributs disabled et aria-disabled=”true” à l’élément interactif |
|
readonly |
Ajoute les attributs readonly et aria-disabled à l’élément interactif |
|
error |
Ajoute un attribut aria-invalid=”true” et un attribut aria-describedby pointant vers le texte d’erreur à l’élément intéractif.Affiche les messages d’erreur. ⚠️ Si cet attribut est ajouté, veillez à ajouter également un attribut error-message. |
|
error-message |
⚠️ Obligatoire si error=”true”Indique à l’utilisateur les erreurs liées au champ |
|
required |
Ajoute l’attribut required à l’élément interactif, et affiche un astérisque à gauche du label |
Navigation et interaction clavier
Gestion du focus :
- L’attribut autofocus permet de donner automatiquement le focus à l’élément si il est défini à true
Bonnes pratiques et pièges à éviter
Référence