microsoft / microsoft/terminal

{Freeway Bug} [Windows Terminal - Settings - Defaults]: Accessible name is not defined for Icon options, causing screen reader to announce only "Icon group collapsed" without the selected icon value.

Open
#20,602 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

A11ySev2 A11yWCAG Area-Accessibility HCL-E+D HCL-WindowsTerminal Issue-Bug Product-Terminal WindowsTerminal_Win32
Dominant language
C++
Stars
105k
Forks
9.6k
Avg merge
3d 17h
Merged PRs (30d)
29

Description

Windows Terminal version

1.25.1912.0

Windows build number

28120.2760

Other Software

Test Environment:
OS: Windows 11 Version Dev (OS Build 28120.2760)
App: Windows Terminal Preview
Screen Reader: Narrator

Steps to reproduce

Repro steps:

  1. Open the 'Windows Terminal' application.
  2. Navigate to 'Settings' control and activate it.
  3. 'Settings' page will open.
  4. Now navigate to 'Defaults' tab in left navigation pane and activate it.
  5. 'Defaults' page will open.
  6. Turn on Narrator by pressing 'Ctrl + Windows + Enter' keys.
  7. Navigate to the 'Icons' button and activate it.
  8. Observe the screen reader announcement.

User Experience:
Screen reader users cannot determine which icon is currently selected because the selected value is not announced. This makes it difficult for users with visual impairments to verify, review, or modify icon settings independently.

Attachment:
https://onedrive.cloud.microsoft/:u:/a@pz6xd287/S/IQDJ3tg0lQkTRbO5z4JXg7InAfQre_9eplu89GLX6C9qTEs?e=ddsmp8

WCAG Reference Link:
https://www.w3.org/WAI/WCAG21/Understanding/name-role-value

Expected Behavior
  • Screen reader announces the control as "Icon group collapsed" (or similar) without conveying the currently selected icon value.
  • The selected icon is represented visually, but the icon option does not expose a meaningful accessible name.
  • Accessibility Insights shows the group name as "Icon", but the selected icon/menu item lacks a descriptive name that can be conveyed to assistive technologies.
Actual Behavior
  • Each icon option should expose a meaningful accessible name through UI Automation.
  • Screen readers should announce both the control label and the currently selected value.
  • Example announcement:
    • "Icon, Terminal icon, collapsed"
    • "Icon, Windows PowerShell icon, collapsed"
    • "Icon, None, collapsed"
  • Users should be able to identify the currently selected icon and available options without relying on visual cues.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start in Windows Terminal Settings on the Defaults page and reproduce the Icons control behavior with Narrator. Trace the control's UI Automation name and selected-value exposure, then verify that Narrator announces the label and selected icon for options such as Terminal, Windows PowerShell, and None.

Written by the indexing model from the issue text.

Assessment

Tech stack
cpp
Domain
accessibility, desktop
Issue type
Bug
Difficulty
3/5
Estimated time
1-2 days
Activity status
Active
Clarity
Mostly clear
Newbie friendliness
58/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.