SIA-R13`<iframe>` elements have an accessible name

Accessibility requirements

This rule tests conformance of the following accessibility requirements:

4.1.2 Name, Role, Value

Description

This rule checks that <iframe> elements have an accessible name.

Applicability

This rule applies to every <iframe> element in the HTML namespace where the element is included in the accessibility tree except if:

the element is marked as decorative; or
the element has a negative tabindex.

Different browsers have different behavior when it comes to <iframe> elements and how they fit in the sequential focus navigation ("tab-order"); for this reason, this rule ignores <iframe> elements for which an attempt was made to hide them from assistive technologies. Depending on the browser used, these may require an accessible name or not.

Expectations

The element has an accessible name that is not empty.

Assumptions

This rule makes no assumptions.

Accessibility support

This rule has no known accessibility support concerns.

Examples

Passed

This <iframe> element has an accessible name that is not empty and therefore passes the rule:

<iframe title="List of Contributors" src="../page-one.html"></iframe>

Failed

This <iframe> element has no accessible name and therefore fails the rule:

<iframe src="../page-one.html"></iframe>

Inapplicable

This <iframe> element is not included in the accessibility tree and is therefore inapplicable:

<iframe style="display:none;" src="../page-one.html"></iframe>

This <iframe> element has a negative tabindex.

<iframe tabindex="-1" src="../page-one.html"></iframe>

SIA-R13<iframe> elements have an accessible name