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".

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

Nobody has claimed this yet.

A11ySev1 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 'Actions' tab in left navigation pane and activate it.
  5. 'Actions' page will open.
  6. Turn on Narrator by pressing 'Ctrl + Windows + Enter' keys.
  7. Navigate to the 'Add New' button and activate it.
  8. Navigate to 'Delete actions' button by pressing tab key.
  9. 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

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

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

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.