A11Y: ARIA-aankondigingen moeten worden gebruikt bij het navigeren door de onderwerplijst met sneltoetsen

AI-generated summary

The discussion addresses an accessibility issue where screen readers fail to announce topic details when users navigate the topic list via keyboard shortcuts J and K. ethindp requested that Discourse implement ARIA announcements to read the topic title and author upon focus, potentially configurable via site texts. awesomerobot agreed this was feasible and comparable to previous discussions on adding headings to topics. ethindp clarified that unlike visual heading changes, this audio feedback should likely be non-optional, as it completes the experience for screen reader users who currently only hear generic labels like “Row 1.”

After a delay, awesomerobot committed to working on it but encountered difficulties with NVDA’s key handling. ethindp advised using Focus Mode (NVDA+Space) to enable J/K navigation without needing to press NVDA+F2 repeatedly.

Subsequently, BrettH proposed an alternative technical solution via a pull request. Instead of using live regions, BrettH suggested assigning an accessible name to each row. This name would be dynamically generated from visible row data, including status (e.g., “New”), title, category, pinned status, author, reply count, views, and last activity. This approach ensures the full context is read upon focus, regardless of how the user navigated to the row (via keyboard, Tab, or mouse). awesomerobot acknowledged the proposal and left feedback on the PR.

Hi all,

This is a rather minor accessibility bug, but would be an incredibly cool feature. I (just) learned that it’s possible to navigate the topic list via K and J, and you can open a topic with O. And it almost works, but NVDA doesn’t announce what topic you’re focused on when doing this. It would be cool if an ARIA announcement was used to only announce the topic title and author when you navigate topics, or even better, it could be a language string you can set in site texts. This would make topic navigation insanely easy and smooth.

5 likes

Great idea, I think this would be possible without too much complication — this would be similar to navigating via heading as suggested in the earlier topic you started, right? (A11Y: topic lists do not have headings for each topic)

3 likes

Yup, it’d be similar. Right now NVDA just says “Row 1”, “Row 2”, etc., but this would complete that. It’s up to you guys whether both are an option that one could disable or not, but I don’t think this should be toggleable, unlike the heading thing which does make a bit more sense if it harms the visual appearance of the site.

2 likes

Any updates on this? If this will take a while that’s alright, just thought I’d check in.

1 like

Not yet, but ideally next week!

so while looking into this, I notice that NVDA doesn’t let me use the K and J navigation… I know there’s a way to “pass the key through” with NVDA+f2… but this has to be pressed every time, are you using some other mode or shortcut to use it that I might be missing?

Hi there,
You can use NVDA+Space to enter and exit focus mode. Then you can press J and K and shift-J/K and such without NVDA+F2.

I proposed an alternate solution to this: build a name for the row, instead of using a live region. The pull request is here: A11Y: Give topic list rows a spoken name - Pull Request #46384 - discourse/discourse - GitHub

j and k already move focus to the row, and NVDA says “row 1”, “row 2” because the row has no name. I give it one, built from what the row shows. A row that is read as “row 3” today would be read as, for example: “New, Can’t upload images in the composer, Pinned, In Support, By alex, 4 replies, 120 views, Last activity 2 hours ago”.

Because it is the name of the focused row, it is read however I get to the row: j and k, Tab, or going back. Nothing is lost if I move fast through the list, and it should work in braille too, though I haven’t confirmed that.

New and new replies come first, so a row might start “New,” or “2 new replies,”. If a row has neither, I can move on to the next topic right away. If it does, I know it is worth reading the rest. A pinned topic’s preview, if the page shows it, comes last.

I tried it in NVDA: j and k land on each row and it reads. NVDA still needs focus mode (NVDA+Space) for j and k to reach the page, as mentioned earlier in this thread. This doesn’t change that.

If you’d want an announcement as well, or a different order, I’d like to hear it.

1 like

Thanks for the proposal! I just left a question on the PR when you have a chance.