-
Notifications
You must be signed in to change notification settings - Fork 10
Decision: Focus in left nav submenu
Thing | Info |
---|---|
Relevant features | Content page |
Date started | 2021-07-13 |
Date finished | 2021-07-13 |
Decision status | Done |
Summary of outcome | Skip through subparts similar to the CMS Design System site |
When navigating by keyboard, "focus" seems to disappear within the left nav sidebar on a content page, because it gets inside the submenus (various sections) without being visibly displayed.
Helpful Chrome settings for testing: "Show a quick highlight on the focused object" + "Navigate pages with a text cursor"
Reference:
- https://webaim.org/techniques/keyboard/
- https://www.washington.edu/accessibility/checklist/focus/
- https://www.w3.org/TR/wai-aria-practices-1.1/examples/accordion/accordion.html
- https://developers.google.com/web/fundamentals/accessibility/focus/using-tabindex
This behavior is confusing - but what should we do instead?
For example: should the left submenu pop open so you can see what you're navigating through? Should it skip from Subpart to Subpart subheading?
Comparison: ATF eRegs skips you through the Subpart subheadings but doesn't enable you to hit enter to expand them.
The navigation on the CMS Design System site works pretty well - skips from submenu item to submenu item, while allowing you to hit enter to expand the submenu item.
Let's make it similar to the CMS Design System: skip through subheadings, hit enter to expand submenu. (That page may also be an interesting example of how to implement "Skip to Main Content" as well.)
The difference is that we have two actions: visiting the subpart as a whole vs visiting a specific section. Tab should go to subpart whole action first, then arrow to expand action, then next subpart.
Change the focus behavior to work more like CMS Design System.
Please note that all pages on this GitHub wiki are draft working documents, not complete or polished.
Our software team puts non-sensitive technical documentation on this wiki to help us maintain a shared understanding of our work, including what we've done and why. As an open source project, this documentation is public in case anything in here is helpful to other teams, including anyone who may be interested in reusing our code for other projects.
For context, see the HHS Open Source Software plan (2016) and CMS Technical Reference Architecture section about Open Source Software, including Business Rule BR-OSS-13: "CMS-Released OSS Code Must Include Documentation Accessible to the Open Source Community".
For CMS staff and contractors: internal documentation on Enterprise Confluence (requires login).
- Federal policy structured data options
- Regulations
- Resources
- Statute
- Citation formats
- Export data
- Site homepage
- Content authoring
- Search
- Timeline
- Not built
- 2021
- Reg content sources
- Default content view
- System last updated behavior
- Paragraph indenting
- Content authoring workflow
- Browser support
- Focus in left nav submenu
- Multiple content views
- Content review workflow
- Wayfinding while reading content
- Display of rules and NPRMs in sidebar
- Empty states for supplemental content
- 2022
- 2023
- 2024
- Medicaid and CHIP regulations user experience
- Initial pilot research outline
- Comparative analysis
- Statute research
- Usability study SOP
- 2021
- 2022
- 2023-2024: 🔒 Dovetail (requires login)
- 🔒 Overview (requires login)
- Authentication and authorization
- Frontend caching
- Validation checklist
- Search
- Security tools
- Tests and linting
- Archive