You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Keep pressing Tab. Notice how focus goes from the logo to the breadcrumbs, then the searchbox, then the site nav, etc. This is very unfriendly to people who rely on Tab-based keyboard navigation of Sphinx docs sites
(This is just one concrete example. You can try out the workflow on other sites based off alabaster, basic, sphinx_rtd_theme, etc.)
Press Tab. Notice that the first option is a link that says "skip to main content". Pressing Enter jumps focus to the main content so that you don't have to tab through all the boilerplate links
Describe the bug
Core Sphinx themes (
alabaster
,basic
, etc.) are missing a simple but important a11y feature - easyTab
based navigationHow to Reproduce
Tab
. Notice how focus goes from the logo to the breadcrumbs, then the searchbox, then the site nav, etc. This is very unfriendly to people who rely onTab
-based keyboard navigation of Sphinx docs sites(This is just one concrete example. You can try out the workflow on other sites based off
alabaster
,basic
,sphinx_rtd_theme
, etc.)Compare this with a Google SERP:
Tab
. Notice that the first option is a link that says "skip to main content". PressingEnter
jumps focus to the main content so that you don't have to tab through all the boilerplate linksWikipedia uses the same pattern as Google SERP: https://en.wikipedia.org/wiki/Sphinx_(documentation_generator)
Environment Information
This feature is missing at least from
basic
,alabaster
, andsphinx_rtd_theme
... and probably lots moreSphinx extensions
N/A
Additional context
I will push up a PR in a bit demonstrating the fix. I'm happy to take it on and try to fix this across all the core themes
The text was updated successfully, but these errors were encountered: