Deutsch
Website-Menü

embed-text-alternative-quality

Textalternative von <embed> muss angemessen sein (manuelle Prüfung)

manualWCAG 1.1.1 (A)Konfidenz: mediumSchweregrad: minorperceivable

Markiert <embed>-Elemente mit erkanntem Namen zur manuellen Prüfung, ob er angemessen ist.

Anwendbarkeit. Gilt für <embed>-Elemente, die bereits eine Textalternative haben: ein nicht leeres aria-label, ein aria-labelledby, das zu nicht leerem Text aufgelöst wird, oder ein nicht leeres title. Ein aria-labelledby, das auf eine fehlende id verweist, wird zu nichts aufgelöst und ist daher keine zu prüfende Textalternative; ein solches Element meldet embed-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.
  • ariaLabel, title: aria-label und title des Elements oder null, wenn es keins hat.
  • ariaLabelledBy: die ids im aria-labelledby des Elements oder null, wenn es keins hat.
  • ariaLabelledByText: der Text, auf den diese ids verweisen, oder null. Wird nur ermittelt, wenn das Element kein aria-label hat, da sonst aria-label den Namen 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

can't tell
<embed src="report.pdf" type="application/pdf" title="Quarterly report PDF">

Ein title ist vorhanden – prüfen Sie, ob es das Dokument für jemanden, der den eingebetteten Viewer nicht sehen kann, ausreichend identifiziert.

n/a
<embed src="report.pdf" type="application/pdf">

Es gibt kein aria-label, kein aufgelöstes aria-labelledby und kein title zum Prüfen; diesen Fall meldet stattdessen embed-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

  1. Sehen Sie sich an, was der im Bericht genannte eingebettete Inhalt zeigt oder tut.
  2. Lesen Sie seine Textalternative (aria-label, Text aus aria-labelledby oder title, wie der Bericht sie angibt).
  3. Prüfen Sie, ob der Text sagt, was der eingebettete Inhalt ist, oder ihn beschreibt.

Bestanden. Die Textalternative identifiziert oder beschreibt den eingebetteten Inhalt zutreffend.

Nicht bestanden. Die Textalternative ist allgemein, falsch oder beschreibt den eingebetteten Inhalt nicht; das verstößt gegen WCAG 1.1.1.

Verwandte Regeln

Quellcode ansehen