Skip to content

Conversation

Copy link
Contributor

Copilot AI commented Jan 14, 2026

Screen readers announce "document" instead of the status message "AI is analyzing..." when users trigger AI performance insights analysis. This violates WCAG 4.1.3 (Status Messages).

Changes

  • Added role="status" and aria-live="polite" to status text in GetPerformanceInsightsCard.tsx to create ARIA live region for screen reader announcements
  • Added aria-hidden="true" to decorative Spinner component to prevent redundant announcements
// Before
<Spinner size="small" />
<Text size={300}>{l10n.t('AI is analyzing...')}</Text>

// After  
<Spinner size="small" aria-hidden="true" />
<Text size={300} role="status" aria-live="polite">
    {l10n.t('AI is analyzing...')}
</Text>

Screen readers will now announce the status message when AI analysis begins, providing equivalent feedback to visual users.

Original prompt

This section details on the original issue you should resolve

<issue_title>NVDA is announcing 'Document' instead of announcing visual status message 'AI is analyzing :A11y_DocumentDB for VS Code Extension_View Query Insights_Screenreader</issue_title>
<issue_description>Please do not close this bug. This bug should only be closed by Trusted Tester after verification.
"Check out Accessibility Insights! - Identify accessibility bugs before check-in and make bug fixing faster and easier."

GitHub Tags

#A11yTCS; #A11yMAS; #A11ySev2; #DesktopApp; #FTP; #Win32; #DocumentDB for VS Code Extension; #SH_DocumentDB_Win32_NOV2025; #WCAG4.1.3; #Screenreader; #NVDA;

Environment Details:

Application Name: DocumentDB for VS Code Extension
Version 0.6.0
OS: Windows 11[Version 23H2(OS Build 22631.3593)]
NVDA 2025

Repro Steps:

  1. Open VS code
  2. Install the DocumentDB for VS Code Extension and open it
  3. Navigate to the DocumentDB Connections area.
  4. Click the New Connection action.
  5. Select Connection String as the connection method.
  6. Paste the connection string when prompted.
  7. Choose to authenticate with username/password and enter the credentials
  8. Confirm to create the connection.
  9. Locate the desired cluster in the DocumentDB Connections list.
  10. Expand the cluster entry to initiate the connection.
  11. Expand one of the databases under the cluster.
  12. Expand a collection within that database.
  13. Select the Documents item for that collection.
  14. Collection View will open
  15. Run the query: { "cuisine": "Thai" }
  16. TAB till "query insights" tab and press ENTER key
  17. TAB till "Get AI performance insights" button and press ENTER key
  18. Observe the issues

Actual Result:

When we hitting ENTER on "Get AI performance insights" button visually "AI is analyzing..." but NVDA instead of announcing visual status message announcing 'document'.

Expected Result:

When we hitting ENTER on "Get AI performance insights" button, Instead of 'document' NVDA should announce the visual status message

User Impact:

Screen reader user will not the status after hitting ENTER on "Get AI performance insights" button.

Attachment

380_NVDA.mp4

</issue_description>

<agent_instructions>use the accessibility skill</agent_instructions>

Comments on the Issue (you are @copilot in this section)


💬 We'd love your input! Share your thoughts on Copilot coding agent in our 2 minute survey.

- Add role="status" and aria-live="polite" to status text for screen reader announcement
- Add aria-hidden="true" to decorative Spinner to prevent redundant announcements
- Fixes WCAG 4.1.3 violation where NVDA was announcing "document" instead of the status message

Co-authored-by: tnaum-ms <[email protected]>
Copilot AI changed the title [WIP] Fix NVDA announcing document instead of visual status message Fix: NVDA announces "document" instead of "AI is analyzing..." status message Jan 14, 2026
Copilot AI requested a review from tnaum-ms January 14, 2026 17:07
@tnaum-ms tnaum-ms marked this pull request as ready for review January 14, 2026 19:16
@tnaum-ms tnaum-ms requested a review from a team as a code owner January 14, 2026 19:16
Copilot AI review requested due to automatic review settings January 14, 2026 19:16
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR fixes a critical accessibility bug where NVDA screen readers announce "document" instead of the intended status message "AI is analyzing..." when users trigger AI performance insights analysis, addressing WCAG 4.1.3 (Status Messages) compliance.

Changes:

  • Added ARIA live region attributes (role="status" and aria-live="polite") to the status text element to ensure screen readers properly announce the loading state
  • Added aria-hidden="true" to the decorative Spinner component to prevent redundant announcements

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

2 participants