object-text-alternative-quality
Textalternative von <object> muss angemessen sein (manuelle Prüfung)
Markiert <object>-Elemente mit erkanntem Fallback oder Namen zur manuellen Prüfung auf Gleichwertigkeit und Angemessenheit.
Anwendbarkeit. Gilt für <object>-Elemente, die bereits eine Textalternative haben: Fallback-Textinhalt, ein nicht leeres aria-label, ein aria-labelledby, das zu nicht leerem Text aufgelöst wird, oder ein nicht leeres title. Ein <object> ohne all das ist ein Fehler von object-text-alternative-present, keine Qualitätsfrage. Das Element muss im Accessibility Tree enthalten sein, und role="presentation"/"none" nimmt es aus dem Geltungsbereich, außer es ist fokussierbar, wodurch seine Rolle wiederhergestellt wird. Ein Objekt, dessen type oder, ohne einen solchen, die Endung seiner data-URL eine HTML-Seite, ein PDF oder reinen Text nennt, bleibt außen vor, so wie object-text-alternative-present es auslässt: Es rendert keine Nicht-Text-Inhalte (ACT 8fc3b6). Ebenso ein Flash-Objekt (type="application/x-shockwave-flash" oder ohne type eine data-URL, die auf .swf endet): Kein aktueller Browser führt Flash aus (die Unterstützung endete 2021), daher zeichnet das Objekt selbst nichts, und der Browser zeigt seinen Fallback-Inhalt, gewöhnliches HTML, das die anderen Regeln beurteilen. Für 1.1.1 bleibt nichts Nicht-Textuelles übrig (ACT 8fc3b6).
Erwartung. Eine manuelle Prüfung ist nötig, um zu bestätigen, dass die bereitgestellte Textalternative zutreffend und angemessen ist.
Was ein Befund meldet.
reasonCode:TEXT_ALTERNATIVE_REVIEW.fallbackText: der Textinhalt innerhalb des <object>, ohne umgebende Leerzeichen, odernull, wenn es keinen gibt.ariaLabel: deraria-label-Wert odernull, wenn es keinen gibt.ariaLabelledBy: deraria-labelledby-Wert, also die ids, auf die er verweist, odernull, wenn es keinen gibt.ariaLabelledByText: der Text der Elemente, auf diearia-labelledbyverweist. Wird nur ermittelt, wenn es keinaria-labelgibt; sonst oder wenn er sich zu nichts auflöstnull.title: dertitle-Wert odernull, wenn es keinen gibt.
Diese Felder in data.details helfen, einen Befund zu lesen und zu reproduzieren. Außer reasonCode und den wenigen Feldern, die Ausgabeschema als stabil nennt, sind sie kein stabiler Vertrag: Ein Feld kann in einer Minor-Version umbenannt werden oder wegfallen, bauen Sie also nicht darauf auf.
Beispiele
<object data="sales-chart.png" type="image/png">Sales chart</object>
Fallback-Text ist vorhanden — es lohnt sich zu bestätigen, dass „Sales chart“ dem Bild tatsächlich gleichwertig ist und nicht nur eine Platzhalter-Beschriftung.
<object data="sales-chart.png" type="image/png"></object>
Es gibt keinen Fallback-Inhalt, keinen ARIA-Namen und kein title, das sich prüfen ließe; das ist stattdessen ein Fehler von object-text-alternative-present.
<object data="brochure.pdf" type="application/pdf">Product brochure (PDF)</object>
Ein PDF rendert Text, keine Nicht-Text-Inhalte, daher verlangt 1.1.1 nichts von ihm (ACT 8fc3b6), so sieht es auch object-text-alternative-present.
So prüfen Sie es
Wenn diese Regel nicht entscheiden kann, meldet sie cantTell und überlässt die Frage einer Person. Jede Frage, die sie stellen kann, steht hier unter ihrem Reason-Code, mit den Schritten, um sie zu beantworten. Ein Befund enthält dieselben Schritte in howToCheck, in der Sprache des Scans. Siehe Ausgabeschema.
TEXT_ALTERNATIVE_REVIEW
- Betrachten Sie das im Bericht genannte Objekt und notieren Sie, was es zeigt oder tut (Bild, Diagramm, Animation, Player).
- Lesen Sie seine Textalternative im Bericht (Ersatztext, aria-label, Text aus aria-labelledby oder title) oder im Bereich „Barrierefreiheit“ der Entwicklertools.
- Nennt die Textalternative das Objekt nur, wie bei Diagrammen und Schaubildern üblich, können die Details anderswo stehen: in einer Bildunterschrift, einem Text oder einer Tabelle daneben oder hinter einem Link daneben. Das zählt nur, wenn Screenreader-Nutzer sie von dem Objekt aus finden und sie alles wiedergeben, was dem Objekt zeigt.
- Vergleichen Sie: Sagt der Text, zusammen mit einer solchen Beschreibung, was das Objekt zeigt, oder bei einem Bedienelement oder Player, wofür es da ist?
Bestanden. Die Textalternative, allein oder mit einer Beschreibung, die Screenreader-Nutzer von ihr aus erreichen, beschreibt Inhalt oder Zweck des Objekts zutreffend.
Nicht bestanden. Die Textalternative ist falsch oder vage (etwa „Objekt“ oder ein Dateiname) oder lässt aus, was das Objekt vermittelt, und keine von ihr aus erreichbare Beschreibung liefert es; das verstößt gegen WCAG 1.1.1.