Rule update: iframe element has accessible name (cae760)

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

@@ -21,7 +21,7 @@ acknowledgments:
 
 ## Applicability
 
-The rule applies to `iframe` elements that are [included in the accessibility tree][] or that are part of [sequential focus navigation][].
+The rule applies to `iframe` elements that are [included in the accessibility tree][] and that can be accessed by [sequential focus navigation][].
 
 **Note:** `frame` element is deprecated, this rule does not consider `frame` or `frameset` elements.
 
@@ -35,8 +35,12 @@ If an `iframe` is not perceived by the user as a single control, it does not qua
 
 ## Accessibility Support
 
-- Some browsers include `iframe` elements in the [sequential focus navigation][]. This ensures that `iframe` elements can always be scrolled using the keyboard. When an `iframe` is removed from the accessibility tree, this rule is still applicable for those browsers, unless the `iframe` is explicitly removed from [sequential focus navigation][] (by having the `tabindex` attribute set to a negative value).
-- Certain assistive technologies can be set up to ignore the title attribute, which means that to some users the title attribute will not act as an [accessible name][].
+- Some browsers include `iframe` elements in the [sequential focus navigation][]. This ensures that the contents of `iframe` elements can be scrolled and accessed by using the keyboard. When an `iframe` is removed from the accessibility tree, this rule is still applicable for those browsers, unless the `iframe` is explicitly removed from [sequential focus navigation][] (by having the `tabindex` attribute set to a negative value).
+
+- Browser and assistive technology support for `iframe` elements is currently **inconsistent**. Some examples of inconsistencies include (but are not limited to):
+  - Assistive technologies being set up to ignore the `title` attribute, which means that to some users the `title` attribute will not act as an [accessible name][],
+  - 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][]
+  - Some assistive technologies ignore empty `iframe` elements, regardless of if they are focusable or if they have an accessible name.
 
 ## Background
 
@@ -53,23 +57,23 @@ If an `iframe` is not perceived by the user as a single control, it does not qua
 This `iframe` element gets its [accessible name][] from the `title` attribute.
 
 ```html
-<iframe title="List of Contributors" src="/test-assets/SC4-1-2-frame-doc.html"> </iframe>
+<iframe title="Grocery List" src="/test-assets/SC4-1-2-frame-doc.html"> </iframe>
 ```
 
 #### Passed Example 2
 
 This `iframe` element gets its [accessible name][] from the `aria-label` attribute.
 
 ```html
-<iframe aria-label="Advertisement of tours to Great Wall of China" src="/test-assets/SC4-1-2-frame-doc.html"> </iframe>
+<iframe aria-label="Grocery list" src="/test-assets/SC4-1-2-frame-doc.html"> </iframe>
 ```
 
 #### Passed Example 3
 
 This `iframe` element gets its [accessible name][] from the content of the `div` referenced with the `aria-labelledby` attribute.
 
 ```html
-<div id="frame-title-helper">Watch highlights of the Worldcup</div>
+<div id="frame-title-helper">Grocery List</div>
 <iframe aria-labelledby="frame-title-helper" src="/test-assets/SC4-1-2-frame-doc.html"> </iframe>
 ```
 
@@ -80,7 +84,7 @@ This `iframe` element gets its [accessible name][] from the content of the `div`
 This `iframe` element has an empty (`""`) [accessible name][]. The `name` attribute is not used in computing the [accessible name][] of `iframe` elements.
 
 ```html
-<iframe name="List of Contributors" src="/test-assets/SC4-1-2-frame-doc.html"> </iframe>
+<iframe name="Grocery List" src="/test-assets/SC4-1-2-frame-doc.html"> </iframe>
 ```
 
 #### Failed Example 2
@@ -101,12 +105,12 @@ This `iframe` element has an empty (`""`) [accessible name][] because the `title
 
 #### Failed Example 4
 
-This `iframe` element has an empty (`""`) [accessible name][] because the `title` attribute value is trimmed of whitespace as part of the accessible name computation.
+This `iframe` element has an empty (`""`) [accessible name][] because the `title` attribute value is trimmed of [whitespace][] by the [accessible name computation][accessible name and description computation].
 
-**note**: Because `iframe` elements are part of [sequential focus navigation][], the [explicit semantic role](#explicit-role) of `none` will be ignored, due to the [Presentational Roles Conflict Resolution](https://www.w3.org/TR/wai-aria-1.1/#presentational-roles-conflict-resolution).
+**Note:**: Because `iframe` elements are part of [sequential focus navigation][], the [explicit semantic role](#explicit-role) of `none` will be ignored, due to the [Presentational Roles Conflict Resolution](https://www.w3.org/TR/wai-aria-1.1/#presentational-roles-conflict-resolution).
 
 ```html
-<iframe title=" " src="/test-assets/SC4-1-2-frame-doc.html" role="none" tabindex="0"> </iframe>
+<iframe title=" " src="/test-assets/SC4-1-2-frame-doc.html" role="none"> </iframe>
 ```
 
 ### Inapplicable
@@ -121,21 +125,23 @@ This page has no `iframe` element.
 
 #### Inapplicable Example 2
 
-This `iframe` is neither part of [sequential focus navigation][], nor [included in the accessibility tree][] because of `display: none;`.
+This `iframe` is not [included in the accessibility tree][] because of setting a style of `display: none;`.
 
 ```html
-<iframe style="display:none;" src="/test-assets/SC4-1-2-frame-doc.html"> </iframe>
+<iframe style="display:none;" src="/test-assets/SC4-1-2-frame-doc.html"></iframe>
 ```
 
 #### Inapplicable Example 3
 
-This `iframe` is not part of [sequential focus navigation][] because it has `tabindex="-1"` and not [included in the accessibility tree][] because of `role="presentation"`
+This `iframe` element has a negative `tabindex` and therefore is not included in the [sequential focus navigation][].
 
 ```html
-<iframe tabindex="-1" role="presentation" src="/test-assets/SC4-1-2-frame-doc.html"> </iframe>
+<iframe tabindex="-1" src="/test-assets/SC4-1-2-frame-doc.html"> </iframe>
 ```
 
 [accessible name]: #accessible-name 'Definition of accessible name'
 [included in the accessibility tree]: #included-in-the-accessibility-tree 'Definition of included in the accessibility tree'
+[whitespace]: #whitespace 'Definition of whitespace'
 [sequential focus navigation]: https://html.spec.whatwg.org/multipage/interaction.html#sequential-focus-navigation
 [user interface component]: https://www.w3.org/TR/WCAG21/#dfn-user-interface-components
+[accessible name and description computation]: https://www.w3.org/TR/accname

test-assets/SC4-1-2-frame-doc.html

@@ -1,3 +1,9 @@
-<p>
-	My Page!
-</p>
+<h1>~Grocery List</h1>
+<ul>
+	<li>Pasta</li>
+	<li>Rice</li>
+	<li>Bread</li>
+	<li>Unsweetened Granola</li>
+	<li>Basil</li>
+	<li>Honey</li>
+</ul>