Skip to content

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

Merged
1 commit merged intomainfrom
dev/cazamor/a11y/7907
Jan 26, 2022
Merged

[Command Palette] Announce if suggestions were found to screen readers#12266
1 commit merged intomainfrom
dev/cazamor/a11y/7907

Conversation

@carlos-zamora
Copy link
Member

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.

@DHowett
Copy link
Member

DHowett commented Jan 26, 2022

THANKS!

@DHowett DHowett added the AutoMerge Marked for automatic merge by the bot when requirements are met label Jan 26, 2022
@ghost
Copy link

ghost commented Jan 26, 2022

Hello @DHowett!

Because this pull request has the AutoMerge label, I will be glad to assist with helping to merge this pull request once all check-in policies pass.

Do note that I've been instructed to only help merge pull requests of this repository that have been opened for at least 8 hours, a condition that will be fulfilled in about 7 hours 42 minutes. No worries though, I will be back when the time is right! 😉

p.s. you can customize the way I help with merging this pull request, such as holding this pull request until a specific person approves. Simply @mention me (@msftbot) and give me an instruction to get started! Learn more here.

@carlos-zamora
Copy link
Member Author

@msftbot merge this in 5 minutes

@ghost
Copy link

ghost commented Jan 26, 2022

Hello @carlos-zamora!

Because you've given me some instructions on how to help merge this pull request, I'll be modifying my merge approach. Here's how I understand your requirements for merging this pull request:

  • I won't merge this pull request until after the UTC date Wed, 26 Jan 2022 23:08:02 GMT, which is in 5 minutes

If this doesn't seem right to you, you can tell me to cancel these instructions and use the auto-merge policy that has been configured for this repository. Try telling me "forget everything I just told you".

@ghost ghost merged commit 1e47d7a into main Jan 26, 2022
@ghost ghost deleted the dev/cazamor/a11y/7907 branch January 26, 2022 23:16
DHowett pushed a commit that referenced this pull request Jan 31, 2022
#12266)

## 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.

(cherry picked from commit 1e47d7a)
ghost pushed a commit that referenced this pull request Jan 31, 2022
Basically, this is the same as #12266, but for the `SearchBoxControl`. Trickily, the ControlCore is the one that knows if there were search results, but the TermControl has to be the one to announce it.

* [x] Will take care of #11973 once a11y team confirms
* [x] Tested manually with Narrator
* [x] Resolves a part of #6319, which I'm repurposing just to displaying the number of results in general. 
* See also #3920
DHowett pushed a commit that referenced this pull request Feb 1, 2022
Basically, this is the same as #12266, but for the `SearchBoxControl`. Trickily, the ControlCore is the one that knows if there were search results, but the TermControl has to be the one to announce it.

* [x] Will take care of #11973 once a11y team confirms
* [x] Tested manually with Narrator
* [x] Resolves a part of #6319, which I'm repurposing just to displaying the number of results in general.
* See also #3920

(cherry picked from commit fbe0416)
@ghost
Copy link

ghost commented Feb 3, 2022

🎉Windows Terminal v1.12.10334.0 has been released which incorporates this pull request.:tada:

Handy links:

@ghost
Copy link

ghost commented Feb 3, 2022

🎉Windows Terminal Preview v1.13.10336.0 has been released which incorporates this pull request.:tada:

Handy links:

This pull request was closed.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

AutoMerge Marked for automatic merge by the bot when requirements are met

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants