embed-text-alternative-present
<embed> must provide a text alternative
automaticWCAG 1.1.1 (A)confidence: highseverity: seriousperceivable
Checks that <embed> elements provide a text alternative via an accessible name.
Applies to. Applies to <embed> elements that are exposed to assistive technologies. Elements otherwise hidden from the accessibility tree remain applicable if they are tabbable or referenced by IDREF relationships (per engine eligibility checks). role="presentation"/role="none" are excluded only when not focusable.
Expectation. Each applicable <embed> provides a text alternative via:
- an accessible name (aria-labelledby/aria-label), OR
- a title attribute (best-effort fallback).
Note: <embed> does not support fallback content in HTML, so this rule does not check children.
Examples
pass
<embed src="report.pdf" type="application/pdf" aria-label="Quarterly report PDF">
`aria-label` gives the embed an accessible name.
fail
<embed src="report.pdf" type="application/pdf">
No accessible name and no fallback content.