Question
Keyboard‑Accessible Controls vs. Non‑Focusable Dropdown for Version Switching: Which Improves Accessibility on Read the Docs?
Rahul Byte
0 reputation · 15 Jul 2020, 11:51 UTC
147K views0
Goal
Make the version selector on Read the Docs fully accessible for users with motor impairments.
Constraint
The current dropdown menu is not keyboard‑focusable, preventing users from switching versions without a mouse or touch interface.
Unresolved Decision
Documentation notes partial support for ARIA landmarks in the navigation pane, but consistent implementation across themes is missing.
Questions
- Would adding keyboard focus and ARIA attributes to the version selector provide sufficient accessibility without breaking existing theme layouts?
- How would the adoption of ARIA landmarks in the navigation pane affect screen‑reader users when combined with a keyboard‑accessible selector?
- What testing strategy should be employed to verify that the changes meet accessibility standards across multiple browsers and themes?