| 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
iframeis 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 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>