Skip to content

fix(config,ui): Settings no longer reads as an overlaid window under NVDA (#514) - #517

Merged
Maxaubert merged 1 commit into
mainfrom
fix/settings-screenreader-514
Oct 26, 2026
Merged

Maxaubert merged 1 commit into
mainfrom
fix/settings-screenreader-514

Conversation

@Maxaubert

Copy link
Copy Markdown
Owner

Closes #514. Field report: Settings had 'an overlaid window above it' under NVDA.

  • Host (src/config_ui/main.cpp): moves keyboard focus into the WebView2 on ready, navigation, activation, WM_SETFOCUS and single-instance re-open; MoveFocusRequested cycles Tab back into the page; WS_SYSMENU for Alt+Space.
  • ui/src/lib/dialog.js: everything outside the topmost dialog is inert while it is open (live region excluded), restored before focus returns.
  • Save capsule: role=region instead of a live region around buttons; first unsaved change announced once.
  • Title bar: no banner landmark, rendered after the page in the DOM (same visuals), initial focus on main.
  • New Playwright a11y tests (CDP accessibility tree), 09-settings-ui.md updated.

Verification: build.bat check, build.bat config, Playwright 217/217, test:rules pass. Deployed signed UIAccess build (combined with #515): Settings opens. Not tested with NVDA.

🤖 Generated with Claude Code

https://claude.ai/code/session_01BjTV6Wj6XLqULZWUmqiVYJ

…NVDA (#514)

Host (src/config_ui/main.cpp):
- Hand keyboard focus to the WebView2 (MoveFocus PROGRAMMATIC) on first paint, after each
  navigation, on WM_ACTIVATE/WM_SETFOCUS, and when a second launch re-opens the window
  (WM_APP_FOCUS_PAGE). Only while the window is active.
- MoveFocusRequested cycles Tab back into the page instead of the empty host window.
- WS_SYSMENU for Alt+Space and the taskbar menu; WM_NCCALCSIZE still removes the caption.

UI:
- lib/dialog.js: while a dialog is open, the siblings of each ancestor of the top dialog are
  inert (new layers too, the live region kept), so only the dialog is in the accessibility tree;
  works for the in-page app-list dialog and full-window prompts. Focus restore after release.
- SaveCapsule: role=region "Unsaved changes" instead of role=status around the buttons; the page
  announces the first unsaved change once (Save/Discard already announce).
- TitleBar: a div, not a banner landmark; brand aria-hidden; rendered after the page in the DOM
  (grid-row keeps it on top), so window buttons come last. Settings opens with focus on main;
  main is named "Search results" while searching.
- Tests: background inert while a prompt / app list is open (checked against Chromium's AX
  tree), capsule not a live region, title bar order, initial focus.
- docs/architecture/09 updated.

Closes #514

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01BjTV6Wj6XLqULZWUmqiVYJ
@Maxaubert
Maxaubert merged commit f296de3 into main Oct 26, 2026
1 check passed
@Maxaubert
Maxaubert deleted the fix/settings-screenreader-514 branch October 26, 2026 08:34
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Settings (WindConfig) reads as an overlaid window under NVDA

1 participant