question-mark
Stuck on an issue?

Lightrun Answers was designed to reduce the constant googling that comes with debugging 3rd party libraries. It collects links to all the places you might be looking at while hunting down a tough bug.

And, if you’re still stuck at the end, we’re happy to hop on a call to see how we can help out.

Report of incorrect a11y guidance for "Make Screen Reader Navigation Easier with the header Landmark"

See original GitHub issue

One of the forum users (Marconiusiii) has raised an issue about this accessibility lesson. Here are their remarks

This article/lesson is teaching a bad a11y practice. h1 elements do not belong in the header region since they are usually the first targeted element by screen reader users. Once I jump to the h1, I am expecting there to be page content ready to go when I start navigating normally element by element down the page. Putting the h1 in the header defeats the purpose of the h1 and the landmark since only repeated elements and object belong in the header, such as logos, navigation regions, search boxes, etc. The h1 will change with each page change, and navigating down from it should move me immediately into the page content, not contend with anything else in the header region.

Skip to content links generally aim for either the main region id or the h1 id, and if I land on an h2 in the main content, I feel like I’ve missed something and try navigating backwards to find the h1.

Please revise the practices being taught here and ensure that coders and designers don’t put their h1s incorrectly into header regions.

<body>
<header>
<!-- h1 elements do not belong here! -->
  <h1>Training with Camper Cat</h1>
</header>

<main>
<!-- h1 elements belong right here! -->

  <section id="stealth">
    <h2>Stealth &amp; Agility Training</h2>
    <article><h3>Climb foliage quickly using a minimum spanning tree approach</h3></article>
    <article><h3>No training is NP-complete without parkour</h3></article>
  </section>

Affected page

Make Screen Reader Navigation Easier with the header Landmark

Issue Analytics

  • State:closed
  • Created 2 years ago
  • Comments:6 (6 by maintainers)

github_iconTop GitHub Comments

1reaction
moT01commented, Aug 17, 2022

I don’t think fixing the legacy challenges is all that important, we can leave those if we want but we should probably fix up the new CatPhotoApp and Cafe Menu projects.

0reactions
ShaunSHamiltoncommented, Oct 4, 2022

On a side note, when you move the header element inside the main element then it loses its banner landmark status and thus basically just becomes a div as far as accessibility is concerned. That’s fine here, there is no need for a banner landmark in this simple menu.

Does this not defeat the purpose of a header? Should we scrap the header all-together from this project?

Read more comments on GitHub >

github_iconTop Results From Across the Web

Make Screen Reader Navigation Easier with the header ...
In this applied accessibility HTML course, we make screen reader navigation easier with the header landmark. This is one video of many in ......
Read more >
Accessibility Information is inaccurate - Contributors
This article/lesson is teaching a bad a11y practice. h1 elements do not belong ... Challenge: Make Screen Reader Navigation Easier with the header...
Read more >
All page content should be contained by landmarks
All page content should be contained by landmarks ... The recommended practice is to keep all content, excluding skip links, in designated areas...
Read more >
Handling common accessibility problems - MDN Web Docs
Hopefully this article has given you a good grounding in the main accessibility problems you might encounter, and how to test and overcome ......
Read more >
ARIA11: Using ARIA landmarks to identify regions of a page
They also provide an easy way for users of assistive technology to skip over blocks of content that are repeated on multiple pages...
Read more >

github_iconTop Related Medium Post

No results found

github_iconTop Related StackOverflow Question

No results found

github_iconTroubleshoot Live Code

Lightrun enables developers to add logs, metrics and snapshots to live code - no restarts or redeploys required.
Start Free

github_iconTop Related Reddit Thread

No results found

github_iconTop Related Hackernoon Post

No results found

github_iconTop Related Tweet

No results found

github_iconTop Related Dev.to Post

No results found

github_iconTop Related Hashnode Post

No results found