id | name | rule_type | description | accessibility_requirements | input_aspects | authors | |||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
cae760 |
iframe has an accessible name |
atomic |
Each iframe element has an accessible name
|
|
|
|
The rule applies to iframe
elements that are included in the accessibility tree.
Note: frame
element is deprecated, this rule does not consider frame
or frameset
elements.
Each target element has an accessible name that is not only whitespace.
- The rule assumes that the target
iframe
is used as an user interface component.
There are no major accessibility support issues known for this rule.
- H64: Using the title attribute of the frame and iframe elements
- Understanding Success Criterion 4.1.2
- Understanding Success Criterion 2.4.1
- User interface component
Usage of title
attribute to describe the iframe
content.
<iframe
title="List of Contributors"
src="../test-assets/SC4-1-2-frame-doc.html"
>
</iframe>
Usage of aria-label
attribute to describe the iframe
content.
<iframe
aria-label="Advertisement of tours to Great Wall of China"
src="../test-assets/SC4-1-2-frame-doc.html"
>
</iframe>
Usage of aria-labelledby
attribute to describe the iframe
content.
<div id="frame-title-helper">Watch highlights of the Worldcup</div>
<iframe
aria-labelledby="frame-title-helper"
src="../test-assets/SC4-1-2-frame-doc.html"
>
</iframe>
Accessible name is not only whitespace.
<iframe title=":-)" src="../test-assets/SC4-1-2-frame-doc.html">
</iframe>
Usage of name
attribute to describe the iframe
content is not valid.
<iframe name="List of Contributors" src="../test-assets/SC4-1-2-frame-doc.html">
</iframe>
iframe
with no title
, aria-label
or aria-labelledby
attribute to describe content is not valid.
<iframe src="../test-assets/SC4-1-2-frame-doc.html"> </iframe>
Empty title
attribute is not valid.
<iframe title="" src="../test-assets/SC4-1-2-frame-doc.html"> </iframe>
Empty aria-label
attribute to describe the frame
content is not valid.
<iframe aria-label="" src="../test-assets/SC4-1-2-frame-doc.html"> </iframe>
Usage of non existing aria-labelledby
reference element to describe the iframe
content is not valid.
<iframe
aria-labelledby="does-not-exist"
src="../test-assets/SC4-1-2-frame-doc.html"
>
</iframe>
Usage of alt
attribute to describe content is not valid.
<iframe alt="List of Contributors" src="../test-assets/SC4-1-2-frame-doc.html">
</iframe>
Accessible name is not only whitespace.
<iframe title=" " src="../test-assets/SC4-1-2-frame-doc.html">
</iframe>
Does not apply to non iframe
element.
<button>take me somewhere</button>
iframe
is not included in the accessibility tree.
<iframe style="display:none;" src="../test-assets/SC4-1-2-frame-doc.html">
</iframe>