These docs are for CORA 0.10, an older release. Read this page in the newest docs.
Frames need titles that tell them apart
- Rule:
axe/frame-title-unique - Checks: Frames must have a unique title attribute
- WCAG: 4.1.2
- Fix class:
content: A fix needs authored text.
Who it affects
Section titled “Who it affects”- People who use a screen reader or a braille display, most of them blind.
How to fix it
Section titled “How to fix it”Frames with different content share a title, often an embed’s default such as “YouTube video player”
Section titled “Frames with different content share a title, often an embed’s default such as “YouTube video player””Give each frame a title that names its own content, such as the video’s topic, decided from what the frame shows. axe reports shared titles for review rather than as failures.
<iframe src="/embed/video/setup" title="Video: setting up your account"></iframe><iframe src="/embed/video/billing" title="Video: managing billing"></iframe>The frames show the same content
Section titled “The frames show the same content”Confirm that they do, and leave them: frames with the same content may share a title.
Fixes that fail
Section titled “Fixes that fail”Numbering the titles, such as Video 1 and Video 2
Section titled “Numbering the titles, such as Video 1 and Video 2”axe accepts them, but screen reader users still cannot tell which frame holds what.
More on the rule
Section titled “More on the rule”axe-core’s documentation of the rule
CORA’s fix guidance adapts content from accessibility-agents, under the MIT License: see its notice.