object-text-alternative-quality
L’alternative textuelle de <object> doit être appropriée (revue manuelle)
Signale les éléments <object> dont un contenu de repli ou un nom a été détecté, pour une revue humaine de son équivalence et de sa pertinence.
Applicabilité. S’applique aux éléments <object> qui portent déjà une alternative textuelle : un contenu textuel de repli, un aria-label non vide, un aria-labelledby qui se résout en texte non vide ou un title non vide. Un <object> qui n’en a aucune relève de l’échec d’object-text-alternative-present, pas d’une question de qualité. L’élément doit être inclus dans l’arbre d’accessibilité, et role="presentation"/"none" le sort du périmètre, sauf s’il est focalisable, ce qui rétablit son rôle. Un objet dont le type, ou à défaut l’extension de son URL data, désigne une page HTML, un PDF ou du texte brut est laissé de côté, comme le fait object-text-alternative-present : il ne rend aucun contenu non textuel (ACT 8fc3b6). De même pour un objet Flash (type="application/x-shockwave-flash", ou, sans type, une URL data qui se termine par .swf) : aucun navigateur actuel n’exécute Flash (sa prise en charge a pris fin en 2021), si bien que l’objet ne dessine rien lui-même et que le navigateur affiche son contenu de repli, du HTML ordinaire que jugent les autres règles. Il ne reste rien de non textuel pour le critère 1.1.1 (ACT 8fc3b6).
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.fallbackText: le contenu textuel à l’intérieur de l’<object>, sans espaces aux extrémités, ounulllorsqu’il n’y en a pas.ariaLabel: la valeuraria-label, ounulllorsqu’il n’y en a pas.ariaLabelledBy: la valeuraria-labelledby, les ids vers lesquels elle pointe, ounulllorsqu’il n’y en a pas.ariaLabelledByText: le texte des éléments vers lesquels pointearia-labelledby. Recherché uniquement en l’absence d’aria-label;nullsinon, ou lorsqu’il ne se résout vers rien.title: la valeurtitle, ounulllorsqu’il n’y en a pas.
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
<object data="sales-chart.png" type="image/png">Sales chart</object>
Un texte de repli est présent : il vaut la peine de vérifier que « Sales chart » est réellement équivalent à l’image, et pas une simple légende de remplissage.
<object data="sales-chart.png" type="image/png"></object>
Aucun contenu de repli, nom ARIA ou title à examiner ; cela relève de l’échec de object-text-alternative-present.
<object data="brochure.pdf" type="application/pdf">Product brochure (PDF)</object>
Un PDF rend du texte, pas un contenu non textuel : le critère 1.1.1 n’en exige donc rien (ACT 8fc3b6), comme le considère aussi object-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 l’objet indiqué par le rapport et notez ce qu’il montre ou fait (image, graphique, animation, lecteur).
- Lisez son équivalent textuel dans le rapport (texte de repli, aria-label, texte de aria-labelledby ou title), ou dans le panneau Accessibilité des outils de développement.
- Si l’équivalent textuel ne fait que nommer l’objet, 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 l’objet et qu’ils donnent tout ce que montre l’objet.
- Comparez : le texte, avec cette description le cas échéant, dit-il ce que montre l’objet ou, pour un contrôle ou un lecteur, à quoi il sert ?
Réussite. L’équivalent textuel, seul ou avec une description qu’un utilisateur de lecteur d’écran atteint depuis lui, décrit avec exactitude le contenu ou la fonction de l’objet.
Échec. L’équivalent textuel est faux ou vague (comme « objet » ou un nom de fichier), ou omet ce que transmet l’objet et aucune description atteignable depuis lui ne le donne, ce qui ne respecte pas le critère WCAG 1.1.1.