embed-text-alternative-quality
L’alternative textuelle de <embed> doit être appropriée (revue manuelle)
Signale les éléments <embed> dotés d’un nom détecté, pour qu’une personne vérifie s’il est approprié.
Applicabilité. S’applique aux éléments <embed> qui portent déjà une alternative textuelle : un aria-label non vide, un aria-labelledby qui se résout en texte non vide, ou un title non vide. Un aria-labelledby qui pointe vers un id inexistant ne se résout en rien et n’est donc pas une alternative textuelle à examiner ; cet élément relève de l’échec d’embed-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.ariaLabel,title: l’aria-labelet letitlede l’élément, ou null lorsqu’il n’en a pas.ariaLabelledBy: les ids de l’aria-labelledbyde l’élément, ou null lorsqu’il n’en a pas.ariaLabelledByText: le texte vers lequel pointent ces ids, ou null. Recherché uniquement lorsque l’élément n’a pas d’aria-label, puisque c’est alorsaria-labelqui donne le nom.
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
<embed src="report.pdf" type="application/pdf" title="Quarterly report PDF">
Un title est présent ; il faut confirmer qu’il identifie suffisamment le document pour une personne qui ne peut pas voir la visionneuse intégrée.
<embed src="report.pdf" type="application/pdf">
Il n’y a ni aria-label, ni aria-labelledby résolu, ni title à examiner ; c’est plutôt l’échec d’embed-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 montre ou fait le contenu intégré indiqué par le rapport.
- Lisez son équivalent textuel (aria-label, texte de aria-labelledby ou title, tel que le donne le rapport).
- Vérifiez que le texte dit ce qu’est le contenu intégré ou le décrit.
Réussite. L’équivalent textuel identifie ou décrit fidèlement le contenu intégré.
Échec. L’équivalent textuel est générique, faux ou ne décrit pas le contenu intégré, ce qui ne respecte pas le critère WCAG 1.1.1.