embed-text-alternative-quality

<embed> text alternative must be appropriate (manual review)

manualWCAG 1.1.1 (A)confidence: mediumseverity: minorperceivable

Flags <embed> elements with a detected name for human review of appropriateness.

Applies to. Applies to <embed> elements that already carry a text alternative: a non-empty aria-label, an aria-labelledby that resolves to non-empty text, or a non-empty title. An aria-labelledby pointing at a missing id resolves to nothing and so is not a text alternative to review; that element is embed-text-alternative-present's failure. The element must be included in the accessibility tree, and role="presentation"/"none" takes it out of scope unless it is focusable, which restores its role.

Expectation. Human review is required to confirm that the provided text alternative is accurate and appropriate.

Examples

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

A `title` is present — worth confirming it identifies the document well enough for someone who can't see the embedded viewer.

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

No aria-label, resolved aria-labelledby, or title exists to review; that's `embed-text-alternative-present`'s failure instead.

View source