a11y(toast): announce updates politely#777
Merged
Merged
Conversation
|
@Devadakene Great news! 🎉 Based on an automated assessment of this PR, the linked Wave issue(s) no longer count against your application limits. You can now already apply to more issues while waiting for a review of this PR. Keep up the great work! 🚀 |
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
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.
Closes #557
Description
This PR introduces a debounced live-region announcement to improve accessibility when toast content updates. Previously, screen-reader users did not receive feedback on the overall count and status of visible toasts when a new toast arrived. This adds a polite live-region announcement that dynamically states the overall count and specific variants (success/error), using a 500ms debounce to prevent spamming the screen reader queue during rapid updates.
Closes #
Type of Change
Pre-flight Checklist
All items must be checked before requesting review.
npm run lintpasses with no errorsnpm testpasses with no failuresnpm run buildcompletes successfullyTesting & Coverage
(run
npm test -- --coverageand check the per-file table)the shared utilities in
src/test-utils/a11y.tsxWhat was tested?
Accessibility & Security Notes
Accessibility
Yes, added a new polite live-region announcement specifically targeted at screen readers to communicate changes to the toast stack that were previously omitted. Testing covers assertions on
aria-liveregions and proper timing to ensure assistive technologies have adequate time to announce the updates.Security
N/A – no authentication or sensitive user logic was altered. Ensure
statusAnnouncementrenders plainly, which it safely does via React state string interpolation.