canvas-text-alternative-present

<canvas> muss eine Textalternative bereitstellen

automaticWCAG 1.1.1 (A)Konfidenz: highSchweregrad: seriousperceivable

Prüft, dass <canvas>-Elemente über Fallback-Inhalt oder einen zugänglichen Namen eine Textalternative bereitstellen.

Anwendbarkeit. Gilt für <canvas>-Elemente, die im Accessibility Tree enthalten sind. Ausgeblendete Elemente werden ausgeschlossen, unabhängig davon, ob sie fokussierbar sind.

Erwartung. Jedes betroffene <canvas> bietet eine Textalternative über Fallback-Inhalt oder einen zugänglichen Namen, mit zwei Ausnahmen:

  • role="img" (das erste Token des role-Attributs, das eine bekannte Rolle nennt, ohne Berücksichtigung der Groß-/Kleinschreibung abgeglichen) macht die Kinder des Canvas präsentational, und sein Name stammt nur vom Autor; Fallback-Inhalt zählt daher nicht: aria-labelledby, aria-label oder title muss ihn benennen.
  • role="none"/"presentation" (auf dieselbe Weise aufgelöst) kennzeichnet das Canvas als dekorativ, und es besteht. Die Rolle wird ignoriert (Konflikt präsentationaler Rollen), wenn das Canvas fokussierbar ist oder aria-label/aria-labelledby trägt; das Canvas wird dann wie jedes andere beurteilt.

Beispiele

pass
<canvas>Chart summary</canvas>

Fallback-Inhalt zwischen den Tags liefert eine Textalternative.

fail
<canvas></canvas>

Kein Fallback-Inhalt und kein zugänglicher Name.

Verwandte Regeln

Quellcode ansehen