microsoft / microsoft/terminal
[Settings]: ‘Columns’ and ‘Rows’ edit box are the editable spin box, but same info is not provided to Screen Reader users.
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.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
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
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