Skip to content

[suggestion] making navigation bar clearer to screen reader users #1725

@kLiHz

Description

@kLiHz

I once shared a mdBook site with a friend who is using screen readers, and we find that the screen reader must walk through all the TOC items before it reaches the Toggle Table of Contents button, as well as the page's main body.

From "Inspect Element" in the web browser, we can see that the Toggle Table of Contents button locates after the <nav> block.

The annoying thing is that this may happen each time a new visitor visits the site, especially when there are a lot of chapters in the TOC. After collapsing the side bar, the screen reader won't read the TOC anymore. Fortunately, once the user clicked the button, the sidebar may not automatically appear again in later tabs.

What I'm wondering is the necessity of making changes to the page's layout, since my friend told me that they can still locate the main text with some shortcuts provided by the screen reader.

Thanks!

Metadata

Metadata

Assignees

No one assigned

    Labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions