microsoft / microsoft/terminal
{Freeway Bug} [Windows Terminal - Settings - New/Edit Action]: Accessible name is missing for 'Delete action' button, causing screen reader to announce only "button".
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 'Actions' tab in left navigation pane and activate it.
- 'Actions' page will open.
- Turn on Narrator by pressing 'Ctrl + Windows + Enter' keys.
- Navigate to the 'Add New' button and activate it.
- Navigate to 'Delete actions' button by pressing tab key.
- Observe the issue here.
User Experience:
Screen reader users cannot determine the purpose of the button because it lacks an accessible name. Users navigating through controls non-visually may be unable to confidently identify that the button performs a delete action, resulting in confusion and reduced usability.
Attachment:
https://onedrive.cloud.microsoft/:u:/a@pz6xd287/S/IQDFxEN2N0MXS5H1LFDX-7pBAVtfLqc9K4Ywye-Ur0VpvJE?e=QHIDgZ
WCAG Reference Link:
https://www.w3.org/WAI/WCAG21/Understanding/name-role-value
Expected Behavior
- The button should expose a meaningful accessible name such as "Delete action".
- Screen readers should announce the control as "Delete action, button" so users can clearly understand the purpose of the control.
Actual Behavior
Screen reader announces the control as "button" only.
The control does not expose a valid Name property through UI Automation.
Accessibility Insights shows:
- ControlType: Button
- Name: Property does not exist
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
Reproduce the issue in Windows Terminal Preview by opening Settings, Actions, Add New, and navigating to the Delete actions button with Narrator or Accessibility Insights. Trace the Settings Actions UI entry point responsible for that button. Done means the control exposes the name "Delete action" and Narrator announces "Delete action, button".
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
- Clearly specified
- Newbie friendliness
- 68/100