Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Output lacks bypass blocks (fails WCAG 2.4.1) #2107

Open
zilac-hue opened this issue Jun 28, 2023 · 0 comments · May be fixed by #2144
Open

Output lacks bypass blocks (fails WCAG 2.4.1) #2107

zilac-hue opened this issue Jun 28, 2023 · 0 comments · May be fixed by #2144
Labels
A-accessibility Area: Accessibility a11y C-bug Category: A bug, incorrect or unintended behavior E-Help-wanted Experience: Help Needed

Comments

@zilac-hue
Copy link

Problem

mdBook currently does not have bypass blocks to skip past content repeated on multiple pages (e.g. the left sidebar and header) when using keyboard navigation. This fails WCAG 2.4.1. Definition below is taken from WCAG 2.4.1.

A mechanism is available to bypass blocks of content that are repeated on multiple Web pages. (Level A)

Steps

  1. Go to an mdbook site (was using https://doc.rust-lang.org/stable/book/)
  2. Press 'tab'
  3. No bypass block is focused on

Possible Solution(s)

Both Astro Starlight and Docusaurus have bypass blocks which can be used as examples. (If you go to either of those pages and press 'tab', a "Skip to main content" button appears).

Notes

No response

Version

Was using https://doc.rust-lang.org/stable/book/ to learn and noticed this, so whatever version of mdBook that was made in (also applies to https://rust-lang.github.io/mdBook/ too)
@zilac-hue zilac-hue added the C-bug Category: A bug, incorrect or unintended behavior label Jun 28, 2023
@ehuss ehuss added A-accessibility Area: Accessibility a11y E-Help-wanted Experience: Help Needed labels Jul 17, 2023
@riverbl riverbl linked a pull request Jul 26, 2023 that will close this issue
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
A-accessibility Area: Accessibility a11y C-bug Category: A bug, incorrect or unintended behavior E-Help-wanted Experience: Help Needed
Projects
None yet
Development

Successfully merging a pull request may close this issue.

2 participants