issue: [a11y] Header navigation has incorrect keyboard focus order (icons are focused before main nav items)
Version Number
Docs website (v7 documentation, latest live version)
Codesandbox/Expo snack
Not applicable ā issue is related to the documentation website UI (header focus order), not the library API. A reproduction Codesandbox is not relevant because the bug is only present on the live docs site.
Steps to reproduce
-
Go to https://react-hook-form.com/get-started
-
Press Tab from the top of the page
-
Observe the focus order in the header
-
The actual sequence becomes
Search ā Dark Mode Toggle ā Discord Icon ā X Icon ā GitHub Icon ā Home ā Get Started ā API ā TS ā Advanced ā ...
-
This order does not match the visual layout of the navigation.
Expected behaviour
The keyboard focus order should follow the visual, logical navigation order:
Search ā Dark Mode Toggle ā Home ā Get Started ā API ā TS ā Advanced ā FAQs ā Tools ā Resources ā Releases ā Discord ā X ā GitHub
This aligns with WCAG 2.4.3 (Focus Order), ensuring keyboard users access the main navigation before social/action icons.
What browsers are you seeing the problem on?
Chrome
Relevant log output
No console errors ā issue relates to incorrect keyboard focus order in the header.
Code of Conduct
- [x] I agree to follow this project's Code of Conduct
Thanks for taking a look!
If you need any additional screenshots, a short video, or deeper debugging, Iām happy to help.
Also open to submitting a PR once the preferred approach is confirmed.
You may want to file an issue for the docs repo. The navbar component is here.