Route diagram: accessibility improvements #53

Open
opened 2026-03-14 21:37:03 +01:00 by claude · 1 comment
Owner

Context

The route diagram page has basic role="img" and aria-label on nodes, and tabIndex on leaf nodes, but several accessibility features from the plan are missing.

What's missing

  • aria-live region to announce when overlay is toggled via E key
  • Full keyboard navigation through diagram nodes (Tab/Shift+Tab between nodes, Enter to select)
  • Color is not the sole state indicator (glow + badge + icon exist), but screen reader announcements for overlay state changes are missing
  • Focus management when detail panel opens/closes

Acceptance criteria

  • E key toggle announces state via aria-live
  • Keyboard-only users can navigate and select diagram nodes
  • Detail panel receives focus when it appears
## Context The route diagram page has basic `role="img"` and `aria-label` on nodes, and `tabIndex` on leaf nodes, but several accessibility features from the plan are missing. ## What's missing - `aria-live` region to announce when overlay is toggled via E key - Full keyboard navigation through diagram nodes (Tab/Shift+Tab between nodes, Enter to select) - Color is not the sole state indicator (glow + badge + icon exist), but screen reader announcements for overlay state changes are missing - Focus management when detail panel opens/closes ## Acceptance criteria - E key toggle announces state via aria-live - Keyboard-only users can navigate and select diagram nodes - Detail panel receives focus when it appears
claude added the accessibilityroute-diagramui labels 2026-03-14 21:40:26 +01:00
Author
Owner

Updated context post-UX overhaul (#69)

With direct row-click navigation to the diagram page, accessibility becomes even more critical:

  • Table rows must be keyboard-navigable (Enter to navigate, not just click)
  • Focus management when arriving at RoutePage — focus should land on the diagram area or a meaningful element
  • The back button (← in breadcrumb) needs proper focus ring and aria-label
  • Screen reader announcement when transitioning between pages ("Navigating to route diagram for {routeId}")
**Updated context post-UX overhaul (#69)** With direct row-click navigation to the diagram page, accessibility becomes even more critical: - Table rows must be keyboard-navigable (Enter to navigate, not just click) - Focus management when arriving at RoutePage — focus should land on the diagram area or a meaningful element - The back button (← in breadcrumb) needs proper focus ring and aria-label - Screen reader announcement when transitioning between pages ("Navigating to route diagram for {routeId}")
Sign in to join this conversation.