Page must contain a level-one heading
How to Fix the Problem
Ensure that the page or at least one of its frames contains a level-one heading.
Generally, it is a best practice to ensure that the beginning of a page's main
content starts with a
h1 element, and also to ensure that the
page contains only one
Usually the best practice is to start the main content of a web page with a
level 1 heading (
h1), with no other headings before this
high-level heading. Mark the sub-sections of the page as level 2 headings
h2). If the level 2 sections contain sub-sections, mark these
children as level 3 sections (
h3) and so on.
The heading hierarchy of an iframe SHOULD be designed to fit within the
heading hierarchy of the parent document, if possible. If you have control
over the content of the embedded document in the iframe, the best practice is
to fit the iframe heading hierarchy into the proper place within the existing
heading hierarchy of the parent page. If the parent document is structured
with a single
h1 at the top of the content (this is a recommended
best practice), the
iframe ought to take this into account, and
not start with another
iframe document ought
to start with
h2 if the content is a direct child of the first
heading on the page, or if it is a child of a level 2 heading, then the first
heading of the iframe should be
h3, and so on.
When iframes contain content from third-party websites — as is often the case — it is not always possible to control the heading hierarchy. Because of the lack of control in these situations, the guidelines don't strictly require the heading hierarchies of the two documents to match, but it would still be better if they did.
Why it Matters
Screen reader users can use keyboard shortcuts to navigate directly to the
h1, which, in principle, should allow them to jump directly
to the main content of the web page. If there is no
h1, or if the
h1 appears somewhere other than at the start of the main content,
screen reader users must listen to more of the web page to understand its
structure, wasting valuable time.
Keep in mind that blind users can't just look at a web page and immediately understand its layout the way that a visual user can. Visual users can take in much information about the page layout without having to read all of the content. Blind users don't have that luxury. Screen readers read linearly, which means listening to the entire web page unless there is some other convenient way to get a "glimpse" of the page's layout and structure. It turns out that headings are a way to do that. Screen reader users can use keyboard shortcuts to navigate through the heading structure of a document.
Ensures that the page, or at least one of its frames, contains an
h1 element that appears before the start of the main content to
allow screen reader users to use keyboard shortcuts to navigate the heading
structure instead of wasting time listening to more of the web page to
understand its structure.
The Algorithm (in simple terms)
This rule finds all elements which match the following selector and verifies that there is at least one: h1:not([role]), [role="heading"][aria-level="1"]