Skip to content

Latest commit

 

History

History
206 lines (162 loc) · 14.3 KB

README.md

File metadata and controls

206 lines (162 loc) · 14.3 KB

Semantics to Screen Readers

April 21, 2021 at An Event Apart Spring Summit

The following resources are structured similarly to the talk outline.

How This Works

Accessibility APIs

Operating System Accessibility API
Android Various APIs in android.view.accessibility, e.g. AccessibilityNodeInfo
Chrome OS Proprietary API closely related to Chromium’s internal accessibility API
Linux/Gnome User apps: Accessibility Toolkit (ATK). Assistive tech: Assistive Technology Service Provider Interface (AT-SPI)
MacOS, iOS NSAccessibility (AXAPI)
Windows Microsoft Active Accessibility + IAccessible2 (MSAA + IA2) or UI Automation (UIA)

Accessibility API Mappings

Accessibility Tree

Text Interfaces

Events

Testing

Checkers and Linters

Manual Testing

Potential Browser + Screen Reader Combinations

These suggestions are largely based on common pairings from the WebAIM screen reader user surveys, and anecdotal knowledge about accessibility API support. This is not a fully exhaustive list, so there are other valid combinations you might want to test. Screen reader names are linked to user docs.

Operating System Browser Screen Reader
Android Chrome Talkback
MacOS, iOS Safari VoiceOver
Windows Chrome JAWS
Windows Microsoft Edge Narrator
Windows Firefox NVDA
Windows Internet Explorer JAWS

Installing and Using Screen Readers

Handy cheatsheets: Screen Reader Keyboard Shortcuts and Gestures (some commands may differ based on your screen reader's current configuration; check the user docs if something isn't working)

Some Screen Reader Actions to Try

  • Read line by line
  • Read continuously from a point
  • Jump by headings, landmarks, and links
  • Search the page
  • Interact with tables using table commands
  • Jump by form field
  • Interact with all interactive elements
  • Testing any changes in content or context

Testing with Users

Bug Sleuthing

Mappings & Web Dev Guidance

Debugging Tools

Browser Dev Tools

Desktop OS API Debuggers

Where to Report Bugs

Misc

Browser Rendering Engine Documentation

Image Credits