Skip to content

Fix accessibility issue: Hide decorative copy success glyph from screen reader navigation#1979

Merged
marcelwgn merged 5 commits intomainfrom
copilot/fix-1964
Jul 30, 2025
Merged

Fix accessibility issue: Hide decorative copy success glyph from screen reader navigation#1979
marcelwgn merged 5 commits intomainfrom
copilot/fix-1964

Conversation

Copy link
Contributor

Copilot AI commented Jul 30, 2025

Fixes an accessibility issue where screen readers would navigate to a decorative copy button image and stay mute, violating Microsoft Accessibility Guidelines (MAS 4.2.1 - Object Information).

Problem

When users navigate with screen reader keyboard navigation (caps + arrow keys) in the Resources page, the narrator focus would land on the decorative success checkmark glyph of the copy button. This caused the narrator to stay silent, creating an "Uncomprehended Element" trap for users with visual impairments.

Solution

Added AutomationProperties.AccessibilityView="Raw" to the success checkmark FontIcon in the CopyButton template. This attribute hides the decorative element from the accessibility tree while preserving the main copy button's accessibility.

Technical Details

  • The main copy button remains fully accessible with AutomationProperties.Name="Copy to clipboard"
  • The button properly announces "Copied to clipboard" when activated
  • Only the decorative success glyph () is hidden from screen reader navigation
  • The copy icon () remains accessible as the button's main content

This is a minimal, surgical fix that addresses the specific accessibility violation without affecting the button's functionality or visual appearance.

Fixes #1964.

Warning

Firewall rules blocked me from connecting to one or more addresses

I tried to connect to the following addresses, but was blocked by firewall rules:

  • e7bvsblobprodcus348.vsblob.vsassets.io
    • Triggering command: dotnet restore WinUIGallery.sln (dns block)

If you need me to access, download, or install something from one of these locations, you can either:


💬 Share your feedback on Copilot coding agent for the chance to win a $200 gift card! Click here to start the survey.

…ader navigation

Co-authored-by: niels9001 <9866362+niels9001@users.noreply.github.com>
Copilot AI changed the title [WIP] [WinUI 3 Gallery: Fundamentals -> Resources]: When user navigated from 'Copy link' button using caps + left arrow key, narrator focus is landing on 'Copy link' image. Fix accessibility issue: Hide decorative copy success glyph from screen reader navigation Jul 30, 2025
Copilot AI requested a review from niels9001 July 30, 2025 10:17
@niels9001 niels9001 marked this pull request as ready for review July 30, 2025 12:44
@niels9001 niels9001 requested a review from marcelwgn July 30, 2025 12:45
@marcelwgn
Copy link
Contributor

/azp run

@marcelwgn marcelwgn merged commit d0c044c into main Jul 30, 2025
2 checks passed
@marcelwgn marcelwgn deleted the copilot/fix-1964 branch July 30, 2025 17:50
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

3 participants