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.
Nobody has claimed this yet.
- 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:
- Open the 'Windows Terminal' application.
- Navigate to 'Settings' control and activate it.
- 'Settings' page will open.
- Now navigate to 'Defaults' tab in left navigation pane and activate it.
- 'Defaults' page will open.
- Turn on Narrator by pressing 'Ctrl + Windows + Enter' keys.
- Navigate to the 'Icons' button and activate it.
- 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
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- 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