[PR #12266] [MERGED] [Command Palette] Announce if suggestions were found to screen readers #28935

Open
opened 2026-01-31 09:31:44 +00:00 by claunia · 0 comments
Owner

📋 Pull Request Information

Original PR: https://github.com/microsoft/terminal/pull/12266
Author: @carlos-zamora
Created: 1/26/2022
Status: Merged
Merged: 1/26/2022
Merged by: @undefined

Base: mainHead: dev/cazamor/a11y/7907


📝 Commits (1)

  • 1b393c2 [Command Palette] Announce if suggestions were found to screen readers

📊 Changes

2 files changed (+10 additions, -10 deletions)

View changed files

📝 src/cascadia/TerminalApp/CommandPalette.cpp (+6 -9)
📝 src/cascadia/TerminalApp/Resources/en-US/Resources.resw (+4 -1)

📄 Description

Summary of the Pull Request

Expands on #9582. If the command palette finds results, the screen reader says "Suggestions available".

Makes the scenario mentioned in #7907 work.

This is sufficient for various reasons:

  1. According to the bug report, saying that suggestions are available is sufficient

Screen reader should provide the results info on searching commands like 10 results found or suggestions available when there are any search results (Source: #7907)

  1. This is common practice. Settings app and XAML Controls Gallery do this for their search box.

Also, the user should be able to know how many results were found by tabbing/selecting a result item. When this is done, the screen reader will use SizeOfSet and PositionInSet to announce how many results were found and which one we're currently on.

Validation Steps Performed

Verified this behavior using Narrator.
Verified it matches the behavior of the Settings app and the XAML Controls Gallery.


🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.

## 📋 Pull Request Information **Original PR:** https://github.com/microsoft/terminal/pull/12266 **Author:** [@carlos-zamora](https://github.com/carlos-zamora) **Created:** 1/26/2022 **Status:** ✅ Merged **Merged:** 1/26/2022 **Merged by:** [@undefined](undefined) **Base:** `main` ← **Head:** `dev/cazamor/a11y/7907` --- ### 📝 Commits (1) - [`1b393c2`](https://github.com/microsoft/terminal/commit/1b393c29f55ceb8fd654ce152ea6c05ba9b1ba7a) [Command Palette] Announce if suggestions were found to screen readers ### 📊 Changes **2 files changed** (+10 additions, -10 deletions) <details> <summary>View changed files</summary> 📝 `src/cascadia/TerminalApp/CommandPalette.cpp` (+6 -9) 📝 `src/cascadia/TerminalApp/Resources/en-US/Resources.resw` (+4 -1) </details> ### 📄 Description ## Summary of the Pull Request Expands on #9582. If the command palette finds results, the screen reader says "Suggestions available". Makes the scenario mentioned in #7907 work. This is sufficient for various reasons: 1. According to the bug report, saying that suggestions are available is sufficient > Screen reader should provide the results info on searching commands like 10 results found or suggestions available when there are any search results (Source: #7907) 2. This is common practice. Settings app and XAML Controls Gallery do this for their search box. Also, the user should be able to know how many results were found by tabbing/selecting a result item. When this is done, the screen reader will use `SizeOfSet` and `PositionInSet` to announce how many results were found and which one we're currently on. ## Validation Steps Performed Verified this behavior using Narrator. Verified it matches the behavior of the Settings app and the XAML Controls Gallery. --- <sub>🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.</sub>
claunia added the pull-request label 2026-01-31 09:31:44 +00:00
Sign in to join this conversation.
No Label pull-request
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: starred/terminal#28935