Skip to content

Commit 7a2abd2

Browse files
committed
Rephrase Applicability (#2079)
1 parent 48eb5de commit 7a2abd2

File tree

1 file changed

+7
-5
lines changed

1 file changed

+7
-5
lines changed

_rules/iframe-non-empty-accessible-name-cae760.md

Lines changed: 7 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -24,9 +24,10 @@ acknowledgments:
2424

2525
## Applicability
2626

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][].
3031

3132
## Expectation
3233

@@ -41,14 +42,14 @@ If an `iframe` is not perceived by the user as a single control, it does not qua
4142
- Browser and assistive technology support for `iframe` elements is currently **inconsistent**. Some examples of inconsistencies include (but are not limited to):
4243
- 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][]
4344
- 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][].
4546
- 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.
4647

4748
## Background
4849

4950
The `frame` element is deprecated, this rule does not consider `frame` or `frameset` elements.
5051

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.
5253

5354
### Bibliography
5455

@@ -157,6 +158,7 @@ This `iframe` element has an [explicit semantic role][] of `none`.
157158
[accessible name and description computation]: https://www.w3.org/TR/accname
158159
[attribute value]: #attribute-value 'Definition of Attribute value'
159160
[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'
160162
[sequential focus navigation]: https://html.spec.whatwg.org/multipage/interaction.html#sequential-focus-navigation
161163
[user interface component]: https://www.w3.org/TR/WCAG21/#dfn-user-interface-components
162164
[whitespace]: #whitespace 'Definition of whitespace'

0 commit comments

Comments
 (0)