canvas-text-alternative-quality
L’alternative textuelle de <canvas> doit être appropriée (revue manuelle)
Signale les éléments <canvas> dotés d’une alternative textuelle détectée, pour qu’une personne vérifie son équivalence et sa pertinence.
Applicabilité. S’applique aux éléments <canvas> qui portent déjà une alternative textuelle : contenu de repli dans l’élément, nom ARIA ou title. Un <canvas> qui n’a rien de tout cela n’a aucune alternative dont on pourrait juger la qualité ; c’est l’échec de canvas-text-alternative-present. L’élément doit être inclus dans l’arbre d’accessibilité, et role="presentation"/"none" l’exclut du périmètre sauf s’il peut recevoir le focus, ce qui rétablit son rôle.
Attendu. Une revue humaine est nécessaire pour confirmer que l’alternative textuelle fournie est exacte et appropriée.
Ce que rapporte un constat.
reasonCode:TEXT_ALTERNATIVE_REVIEW.value: l’alternative textuelle à examiner. Lorsque le contenu de repli n’a pas de texte propre mais contient une image avec un texte alt ou un élément avec un aria-label, c’est la valeur de remplacementfallback-content.mechanism: la provenance de l’alternative textuelle :canvas-fallback(contenu à l’intérieur du <canvas>),aria-labelledby,aria-labeloutitle.flags: des remarques sur la façon dont l’alternative textuelle a été trouvée, commetitle-usedlorsque seul l’attribut title la fournit.
Ces champs de data.details aident à lire et à reproduire un constat. À part reasonCode et les quelques champs que la page Schéma de sortie donne comme stables, ils ne constituent pas un contrat stable : un champ peut être renommé ou supprimé dans une version mineure, ne vous appuyez donc pas dessus.
Exemples
<canvas width="400" height="200">Bar chart</canvas>
Le texte de repli « Bar chart » est présent mais générique ; il faut confirmer qu’il transmet les données réelles, et pas seulement le type de graphique.
<canvas width="400" height="200"></canvas>
Il n’y a ni contenu de repli, ni nom ARIA, ni title à examiner ; c’est plutôt l’échec de canvas-text-alternative-present.
Comment vérifier
Quand cette règle ne peut pas trancher, elle renvoie cantTell et laisse la question à une personne. Chaque question qu’elle peut poser figure ici sous son code de raison, avec les étapes pour y répondre. Un constat porte les mêmes étapes dans howToCheck, dans la langue de l’analyse. Voir Schéma de sortie.
TEXT_ALTERNATIVE_REVIEW
- Regardez ce que le canvas indiqué par le rapport affiche à l’écran, y compris ses changements quand vous l’utilisez.
- Lisez son équivalent textuel (la valeur donnée par le rapport, ou son contenu de repli et son nom dans le panneau Accessibilité).
- Si l’équivalent textuel ne fait que nommer le canevas, comme c’est courant pour les graphiques et les schémas, les détails peuvent se trouver ailleurs : dans une légende, un texte ou un tableau à côté, ou dans un lien juste à côté. Cela ne compte que si un utilisateur de lecteur d’écran peut les trouver depuis le canevas et qu’ils donnent tout ce que montre le canevas.
- Vérifiez que le texte, avec cette description le cas échéant, transmet la même information ou fonction que le dessin, et suit ses changements.
Réussite. L’équivalent textuel, seul ou avec une description qu’un utilisateur de lecteur d’écran atteint depuis lui, donne la même information ou fonction que ce que montre le canevas.
Échec. Ni l’équivalent textuel ni une description atteignable depuis lui ne donnent l’information que montre le canevas, ou le texte est vague ou faux, ce qui ne respecte pas le critère WCAG 1.1.1.