The Landmark Region Completeness Checker verifies that a page exposes the ARIA landmark regions screen-reader users rely on to navigate. Missing or misused landmarks create dead-ends: content that has no shortcut, ambiguous main regions, or duplicate menus a user cannot tell apart.
How it works
- Map the landmarks. The HTML is parsed and every landmark is identified —
main,nav, andasidealways count;headerandfootercount only when they sit at the top level (a header inside anarticleis not a banner). Explicitroleattributes are honoured. - Apply the rules. The checker confirms there is exactly one top-level
main, a bannerheader, and a contentinfofooter; that any second-or-laternavhas an accessible name; and that no headings, paragraphs, or controls sit outside every landmark. - Report. Each rule is marked as a pass, a suggestion (warn), or a problem (error) with a plain-language explanation of what to change.
Example
A page with <header>, <main>, a footer <nav>, and a <footer> passes the structural rules — but if both the header nav and the footer nav are unnamed, the checker flags that the two navigation landmarks cannot be told apart and recommends aria-label="Primary" and aria-label="Footer".
Tips and notes
- Aim for one
main, one banner, one contentinfo, and clearly named navs as the baseline on every template. - Wrap any floating widget or call-to-action in
mainor an appropriate region so landmark navigation does not skip it. - This is a structural check; pair it with the Screen Reader Announcement Simulator to confirm the regions are also announced sensibly.