microsoft / microsoft/terminal

[Terminal >Actions]: Screen Reader users are not able to know the purpose of Actions List inside Actions tab page.

Open
#12,057 1 comment 0 reactions 0 assignees View on GitHub
A11yCO A11ySev3 A11yWCAG Area-Accessibility HCL-E+D HCL-WindowsTerminal Issue-Bug Priority-3 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

### Steps to reproduce

**Repro Steps:**
1. Open Windows Terminal.
2. Open Settings page using 'Ctr+,'.
3. Open Narrator using 'Win + Ctrl + Enter' keys.
4. Activate 'Actions' tab and then navigate to actions list using tab/arrow keys and observe the issue.

**User Experience:**
Screen Reader users UX will not be good as they are not able to know the purpose of list item when they navigate to them.

**Guideline Reference:**
https://www.w3.org/WAI/WCAG21/Understanding/info-and-relationships

**Attachments:**
[Screen Reader users are not able to know the purpose of Actions List inside Actions tab page..zip](https://github.com/microsoft/terminal/files/7783331/Screen.Reader.users.are.not.able.to.know.the.purpose.of.Actions.List.inside.Actions.tab.page.zip)

### Expected Behavior

Screen Reader users should be able to know the purpose of Actions List inside Actions tab page.
i.e. When user first time jumps to 'Actions' list item control, Screen Reader should announce something like this 'Actions List item, Use these actions to perform available functionality inside Terminal Text Area....'

### Actual Behavior

Screen Reader users are not able to know the purpose of Actions List inside Actions tab page.

**Observation:** Same issue repro with NVDA and JAWS Screen Reader.

Contributor guide

Open the contributing guide

Research direction

Reproduce the issue in Windows Terminal's Settings > Actions page with Narrator, then compare the announcement when first navigating to the Actions list using Narrator, NVDA, or JAWS. Trace the Actions list's accessibility information and verify that the list purpose is announced clearly without disrupting navigation.

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.