You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: _rules/iframe-non-empty-accessible-name-cae760.md
+7-5Lines changed: 7 additions & 5 deletions
Original file line number
Diff line number
Diff line change
@@ -24,9 +24,10 @@ acknowledgments:
24
24
25
25
## Applicability
26
26
27
-
This rule applies to `iframe` elements that are [included in the accessibility tree][] and for which all of the following are true:
28
-
- the `iframe` does not have a negative `tabindex`[attribute value][]; and
29
-
- the `iframe` does not have an [explicit semantic role][] of `presentation` or `none`.
27
+
This rule applies to `iframe` elements that are [included in the accessibility tree][] except if at least one of the following is true:
28
+
29
+
- the `iframe` has a negative `tabindex`[attribute value][]; or
30
+
- the `iframe` is [marked as decorative][].
30
31
31
32
## Expectation
32
33
@@ -41,14 +42,14 @@ If an `iframe` is not perceived by the user as a single control, it does not qua
41
42
- Browser and assistive technology support for `iframe` elements is currently **inconsistent**. Some examples of inconsistencies include (but are not limited to):
42
43
- There is a known combination of a popular browser and assistive technology that ignores `aria-label` and only announces `title` attribute as an [accessible name][]
43
44
- Some assistive technologies ignore empty `iframe` elements, regardless of if they are focusable or if they have an accessible name.
44
-
- Some browsers instantly redirect focus from `iframe` elements to the first focusable element inside that iframe. This redirect makes it appear as though the `iframe` never receives focus. This occurs even if the `iframe` has a non-negative `tabindex`[attribute value][].
45
+
- Some browsers instantly redirect focus from `iframe` elements to the first focusable element inside that iframe. This redirect makes it appear as though the `iframe` never receives focus. This occurs even if the `iframe` has a non-negative `tabindex`[attribute value][].
45
46
- Not all browsers redirect focus on `iframe` elements. This ensures that the contents of `iframe` elements can be scrolled and accessed by using the keyboard. This must not be circumvented by using a negative tabindex, as this will make the `iframe` completely inaccessible for keyboard navigation.
46
47
47
48
## Background
48
49
49
50
The `frame` element is deprecated, this rule does not consider `frame` or `frameset` elements.
50
51
51
-
Due to inconsistencies in handling focus on `iframe`, this rule ignores `iframe` elements for which there is an attempt to hide them from assistive technologies. Whether `iframe` elements that are inapplicable to this rule still require an accessible name varies between browsers.
52
+
Due to inconsistencies in handling focus on `iframe`, this rule ignores `iframe` elements for which there is an attempt to hide them from assistive technologies. Whether `iframe` elements that are inapplicable to this rule still require an accessible name varies between browsers.
52
53
53
54
### Bibliography
54
55
@@ -157,6 +158,7 @@ This `iframe` element has an [explicit semantic role][] of `none`.
157
158
[accessible name and description computation]: https://www.w3.org/TR/accname
158
159
[attribute value]: #attribute-value'Definition of Attribute value'
159
160
[included in the accessibility tree]: #included-in-the-accessibility-tree'Definition of included in the accessibility tree'
161
+
[marked as decorative]: #marked-as-decorative'Definition of Marked as Decorative'
0 commit comments