microsoft / microsoft/terminal

[Terminal]: Extra info which only appear on Tooltip is not announced by Screen Reader for some controls throughout Terminal app.

Open
#12,028 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

A11yCO A11yUsable 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.12.3472.0

### Windows build number

10.0.22504.1010

### Other Software

**Test Environment:**
OS: Windows 11 Version Dev (OS Build 22504.1010)
App: Windows Terminal Preview
Screen Reader: Narrator
Tool: Accessibility Insights for Windows Version 1.1.1741.1

### Steps to reproduce

**Repro Steps:**
1. Open Windows Terminal.
2. Open Settings page using 'Ctr+,'.
3. Open Narrator using 'Win + Ctrl + Enter' keys.
4. Then navigate to all controls whose have tooltip like 'Open JSON file' and observe the issue.

**User Experience:**
Screen Reader users UX will not be good if they will miss some important info which only appear on tooltips.

**Attachments:**
[Extra info which only appear on Tooltip is not announced by Screen Reader for some controls throughout Terminal app..zip](https://github.com/microsoft/terminal/files/7773131/Extra.info.which.only.appear.on.Tooltip.is.not.announced.by.Screen.Reader.for.some.controls.throughout.Terminal.app.zip)

### Expected Behavior

Extra info which only appears on Tooltip should be announced by Screen Reader for all controls throughout Terminal app.
i.e. For 'Open JSON file', Tooltip is 'Open your Settings.json file, Alt+ Click to open defaults.json file' and Screen Reader should announce something like this 'Open your Settings.json file, Alt+ Click to open defaults.json file 1 of 1'

### Actual Behavior

Extra info which only appears on Tooltip is not announced by Screen Reader for some controls throughout Terminal app.
i.e. For 'Open JSON file', Tooltip is 'Open your Settings.json file, Alt+ Click to open defaults.json file' and Screen Reader is only announcing 'Open JSON file 12 of 12'

**Observation:**
Issue repro with NVDA Screen Reader
Narrator users have option to read tooltips using shortcut key 'Caps lock + 0' keys.

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 on the Settings page with Narrator or NVDA, focusing on controls with tooltips such as “Open JSON file.” Trace how those controls expose their accessible name and tooltip text; done means screen readers announce the tooltip-only information consistently throughout the Terminal app.

Written by the indexing model from the issue text.

Assessment

Tech stack
cpp
Domain
accessibility, desktop
Issue type
Bug
Difficulty
4/5
Estimated time
3-5 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.