[SG-36606] Accessibility: Provide screen reader context for sublists of ref panel
Created by: gitstart-sourcegraph
Audit type
Screen reader navigation
User journey audit issue
Problem description
When navigating through the ref panel, VoiceOver directly announces the repo names and file paths without saying that they are repo names or file paths. From the POV of a screen reader user, this seems a little disorienting, because there is a change in level of abstraction, but you only realize that after hearing a bit more
Expected behavior
It would be better for the screen reader to announce "repository" before it reads out the repository name and "file path" before it reads a file path.
Additional details
Example ref panel link. It can be triggered by hovering over an identifier and clicking on Find References or Find Implementations (if visible).
NOTE: There are two ref panels, the "new one" and the "old one"; the new one can be triggered by clicking the "Try the new reference panel experience!" Here is a screenshot of what the new ref panel looks like:
It'd be nice to fix both if it is easy enough, but I think it makes sense to prioritize fixing the new one.
Refs
Sourcegraph Issue Gitstart Ticket
Description:
- When navigating through the ref panel, VoiceOver directly announces "repository" before it reads out the repository name and "file path" before it reads a file path.
Test plan
- On the search result page. Click on the file path and once the file is open, the ref panel can be triggered by hovering over an identifier and clicking on Find References or Find Implementations (if visible).
Loom Video
App preview:
Check out the client app preview documentation to learn more.