canvas-text-alternative-quality
Textalternative von <canvas> muss angemessen sein (manuelle Prüfung)
Markiert <canvas>-Elemente mit erkannter Textalternative zur manuellen Prüfung, ob sie gleichwertig und angemessen ist.
Anwendbarkeit. Gilt für <canvas>-Elemente, die bereits eine Textalternative haben: Fallback-Inhalt im Element, einen ARIA-Namen oder ein title. Ein <canvas> ohne all das hat keine Alternative, deren Qualität sich beurteilen ließe; diesen Fall meldet canvas-text-alternative-present als Verstoß. Das Element muss im Accessibility Tree enthalten sein, und role="presentation"/"none" nimmt es aus dem Geltungsbereich, sofern es nicht fokussierbar ist, was seine Rolle wiederherstellt.
Erwartung. Eine manuelle Prüfung ist nötig, um zu bestätigen, dass die angegebene Textalternative zutreffend und angemessen ist.
Was ein Befund meldet.
reasonCode:TEXT_ALTERNATIVE_REVIEW.value: die zu prüfende Textalternative. Wenn der Fallback-Inhalt keinen eigenen Text hat, aber ein Bild mit Alt-Text oder ein Element mit aria-label enthält, ist dies der Platzhalterfallback-content.mechanism: woher die Textalternative stammt:canvas-fallback(Inhalt innerhalb des <canvas>),aria-labelledby,aria-labelodertitle.flags: Hinweise dazu, wie die Textalternative gefunden wurde, etwatitle-used, wenn nur das title-Attribut sie liefert.
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
<canvas width="400" height="200">Bar chart</canvas>
Der Fallback-Text „Bar chart“ ist vorhanden, aber allgemein – prüfen Sie, ob er die tatsächlichen Daten vermittelt und nicht nur den Diagrammtyp.
<canvas width="400" height="200"></canvas>
Es gibt keinen Fallback-Inhalt, keinen ARIA-Namen und kein title zum Prüfen; diesen Fall meldet stattdessen canvas-text-alternative-present als fail.
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
- Sehen Sie sich an, was das im Bericht genannte Canvas auf dem Bildschirm zeigt, einschließlich etwaiger Änderungen während der Nutzung.
- Lesen Sie seine Textalternative (den Wert, den der Bericht angibt, oder seinen Ersatzinhalt und Namen im Bereich „Barrierefreiheit“).
- Nennt die Textalternative die Zeichenfläche 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 der Zeichenfläche aus finden und sie alles wiedergeben, was der Zeichenfläche zeigt.
- Prüfen Sie, ob der Text, zusammen mit einer solchen Beschreibung, dieselbe Information oder denselben Zweck wie die Zeichnung vermittelt und mitzieht, wenn sich die Zeichnung ändert.
Bestanden. Die Textalternative, allein oder mit einer Beschreibung, die Screenreader-Nutzer von ihr aus erreichen, gibt dieselbe Information oder denselben Zweck wieder wie das, was die Zeichenfläche zeigt.
Nicht bestanden. Weder die Textalternative noch eine von ihr aus erreichbare Beschreibung gibt die Information wieder, die die Zeichenfläche zeigt, oder der Text ist vage oder falsch; das verstößt gegen WCAG 1.1.1.