screen-reader-testing

Installation
SKILL.md

Test with screen readers

Screen readers are the primary interface for blind users and many users with severe low vision or motor disabilities. Automated accessibility scanners cannot detect incorrect announcements, wrong reading order, missing context, focus traps, or broken keyboard interactions. A page that passes automated checks can still be completely unusable by a screen reader user. Manual screen reader testing with representative tasks is the only way to verify real usability for this population.

Quick Reference

  • Automated tools catch ~30-40% of accessibility issues — screen reader testing finds the rest
  • Test with NVDA + Chrome or Firefox on Windows; JAWS + Chrome on Windows; VoiceOver + Safari on macOS/iOS; TalkBack + Chrome on Android
  • Verify: all interactive elements are reachable by keyboard, announced correctly, and operable
  • Check dynamic content: live regions (aria-live), modal dialogs (focus trap), and custom widgets (menus, tabs, trees)
  • Test real user flows: form completion, navigation to a destination, error correction

Check

Test the page with at least two screen reader / browser combinations: (1) NVDA + Chrome (Windows) or VoiceOver + Safari (macOS). Navigate using only the keyboard: Tab for focusable elements, arrow keys for widgets, heading navigation (H key in NVDA/JAWS), landmark navigation (D/R keys), and links list (NVDA: Insert+F7). Verify: all interactive elements are reachable and announced with name + role + state; custom widgets (menus, tabs, dialogs) follow ARIA Authoring Practices Guide keyboard patterns; dynamic updates are announced via live regions; focus is managed correctly when modals open and close.

Fix

Common issues and fixes: (1) Missing accessible names — add aria-label or associate elements. (2) Wrong reading order — reorder DOM structure to match visual order; use CSS for visual reordering only. (3) Focus lost after modal closes — return focus to the trigger element. (4) Dynamic content not announced — add aria-live='polite' (non-critical) or aria-live='assertive' (critical alerts) to containers. (5) Custom widget not keyboard operable — implement ARIA APG keyboard patterns (roving tabindex for menus, arrow keys for tabs). (6) Form errors not announced — associate error messages via aria-describedby or use aria-live regions.

Installs
5
GitHub Stars
73.9K
First Seen
Jul 6, 2026
screen-reader-testing — thedaviddias/front-end-checklist