Assistive technology announcements
Events like toasts and status messages are visually communicated to GitHub users. Making sure those announcements are read via assistive technology allows users with low or no vision to get that status information.
On this page
On this page
Overview
These guidelines will help you determine when assistive tools should output a message.
Guidelines
- Always: Announce location changes — Help users understand where they are on a page. Maintain positional awareness.
- Always: Announce results of user actions — Give feedback about the success or failure directly following a user action.
- Sometimes: Announce other changes — Explore case-by-case when changes are disconnected from the user’s place and the success or failure of the user’s actions. For example:
- Distracting change announcements: When other users add issue comments; when presence indicators appear
- Essential change announcements: When log lines stream in on the GitHub Actions workflow run page
Additional resources
- Deep Dive: Page and Navigation transitions, Dynamic Content, and SPAs (only accessible to GitHub staff)
- Deep Dive: Save Patterns & Status Messages (only accessible to GitHub staff)