microsoft / microsoft/terminal

[Settings]: In Scan mode, Reading order of Title bar, System Settings, minimize, maximize, and close control is incorrect.

Open
#11,260 2 comments 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 (or Windows build number)

1.10.2383.0

### Other Software

**Test Environment:**
OS: Windows 11 Version 21H2 (OS Build 22000.168)
Screen Reader: Narrator
Tool: Accessibility Insight for Windows

### Steps to reproduce

**Repro Steps:**
1. Open Windows Terminal.
2. Open Settings page using "Ctrl + ',' ".
3. Open Narrator using 'Win + Ctrl + Enter' key and ensure Scan mode is ON.(Turn on Scan on mode using 'Caps lock + Space' keys).
4. Navigate after 'Save' button in scan mode using 'down' arrow key.
5. Observe the issue.

**User Experience:**
Screen Reader user will be impacted here if reading order of control is incorrect as result, they will get confused and find difficulty to found them if they are come in expected reading order.

**Guideline Reference:**
https://www.w3.org/WAI/WCAG21/Understanding/meaningful-sequence

**Attachments:**
[Reading order of Title bar, System Settings, minimize, maximize, and close control is incorrect when Screen Reader user navigate in scan mode by arrow key as it is coming after last control..zip](https://github.com/microsoft/terminal/files/7185019/Reading.order.of.Title.bar.System.Settings.minimize.maximize.and.close.control.is.incorrect.when.Screen.Reader.user.navigate.in.scan.mode.by.arrow.key.as.it.is.coming.after.last.control.zip)

### Expected Behavior

Title bar, System Settings, minimize, maximize, and close control should come first in reading order when Screen Reader user navigate in scan mode by arrow key.

### Actual Behavior

Reading order of Title bar, System Settings, minimize, maximize, and close control is incorrect when Screen Reader user navigate in scan mode by arrow key as it is coming after last control. Same issue repro throughout the app.

Contributor guide

Open the contributing guide

Research direction

Start by reproducing the Settings-page behavior in Windows Terminal 1.10.2383.0 with Narrator Scan mode and verify the control sequence after the Save button. Inspect the Settings UI accessibility and navigation entry points; done means the title bar, System Settings, minimize, maximize, and close controls are encountered first throughout the app, with the reported reproduction no longer occurring.

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
25/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.