feat(a11y): F6 focus zones + spoken hover for chrome buttons#49
Merged
Conversation
…rome buttons
Follow-up to the Text pattern, from live Narrator use: there was no way to move
keyboard focus OUT of the terminal, and hovering chrome buttons said nothing.
- F6 lifts keyboard focus from the terminal to the SIDEBAR zone (reveals it if
hidden). There: Up/Down/Home/End walk sessions with a visible focus ring +
a spoken announcement ("<name>, session, current, N unread"); Enter/Space
opens the focused session; Escape/F6 returns to the terminal. A click in the
terminal also leaves the zone. This is the accessible "how do I get out of
the terminal" gesture (F6 is the Windows convention for cycling panes).
- Hovering a chrome button (Quick terminal, Scratch terminal, Split pane,
Settings, New session/workspace, Toggle sidebar, …) now speaks its name via
a UIA notification event — gated on a screen reader actually listening.
Verified live: F6 -> sidebar, arrow navigation moves the focus ring across
alpha/beta/gamma with the name announced. 110/110 Core, 38/38 Pty.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
From live Narrator use: no way to move keyboard focus out of the terminal, and hovering chrome buttons was silent.
F6 — leave the terminal
F6lifts keyboard focus from the terminal to the sidebar zone (revealing it if hidden). There:F6 is the Windows convention for cycling a window's panes, so it's the natural "how do I get out of the terminal" gesture — useful for every keyboard user, not just Narrator.
Spoken hover for chrome buttons
Hovering Quick terminal, Scratch terminal, Split pane, Settings, New session/workspace, Toggle sidebar, … now speaks the button name (UIA notification event, gated on a reader actually listening).
Verified
Live: F6 → sidebar, arrows move the focus ring across alpha/beta/gamma with the name announced (screenshot). 110/110 Core, 38/38 Pty.
Note on "vertical split" on activation
Not in our UIA tree (it's flat: one Document). It's the Windows 11 snap-layout hint synthesized on the maximize caption button — separate from agwinterm. Can suppress snap layouts for the window if it's bothersome.
Scope
This gives keyboard navigation + spoken feedback now. A formal fragment tree (so Narrator's own Tab/scan walks each control as a first-class element) is the deeper follow-up.
🤖 Generated with Claude Code