microsoft / microsoft/terminal

[Settings]: ‘Columns’ and ‘Rows’ edit box are the editable spin box, but same info is not provided to Screen Reader users.

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

Nobody has claimed this yet.

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
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' key. Turn OFF Narrator scan mode using 'Caps lock + Space' key.
4. Activate 'Startup' tab and then navigate to 'Columns' edit field then observe the issue.

**User Experience:**
Screen Reader users will be impacted here as they are not able to know about the spin property of edit control, which will not enhance the UX of those users.

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

**Attachments:**
[‘Columns’ and ‘Rows’ edit box are the editable spin box, but same info is not provided to Screen Reader users..zip](https://github.com/microsoft/terminal/files/7750603/Columns.and.Rows.edit.box.are.the.editable.spin.box.but.same.info.is.not.provided.to.Screen.Reader.users.zip)

### Expected Behavior

Screen Reader should give some hint about ‘Columns’ and ‘Rows’ edit box 'spin' property.
i.e. For Column with value 120 Screen Reader should announce something like this 'Columns Spinner edit 120' OR 'Columns edit 120 Use up or down arrow keys to increase or decrease count'

### Actual Behavior

‘Columns’ and ‘Rows’ edit box are the editable spin box, but same info is not provided to Screen Reader users. _Issue repro with all spinner edit fields._
i.e. For Column with value 120 Screen Reader is announcing 'Column edit 120'.

**Observation:** Issue not repro with NVDA as it announce 'Column Spin button Columns edit selected 120'

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

Start by reproducing the Columns and Rows controls in the Windows Terminal Settings Startup tab with Narrator, using the reported Windows Terminal and Windows build details. Locate the implementation of the spinner edit fields and verify the result with a screen reader; done means the controls expose their spin behavior and usable increment/decrement guidance, including the other spinner edit fields mentioned.

Written by the indexing model from the issue text.

Assessment

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

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.