search

dotnet / docs-maui

This repository contains documentation for .NET Multi-platform App UI (MAUI).
https://docs.microsoft.com/dotnet/maui
Creative Commons Attribution 4.0 International
230 stars 200 forks source link

SemanticProperties.Description Required for Mac Voice Control #2442

Open tj-devel709 opened 3 months ago

tj-devel709 commented 3 months ago

Type of issue

Missing information

Description

There is some discrepancy between the platforms when it comes to SemanticProperties.Description and our suggestions. It appears that to use Voice Control (speech input) on Mac, it is better to use the SemanticProperties.Description on Entries so that the Voice Control can access these entries. For example, assigning a SemanticProperties.Description of "Name" allows the Voice Control to recognize me saying "Click Name" and that entry will be focused.

I am just not sure how this should be worded exactly and if this is something that can be improved in the future. I think a work around for now, as to not conflict with the other bullets on this subject, would be to use OnPlatform such as SemanticProperties.Description="{OnPlatform MacCatalyst=Recipe Name}" https://learn.microsoft.com/en-us/dotnet/maui/platform-integration/customize-ui-appearance?view=net-maui-8.0

image

Page URL

https://learn.microsoft.com/en-us/dotnet/maui/fundamentals/accessibility?view=net-maui-8.0

Content source URL

https://github.com/dotnet/docs-maui/blob/main/docs/fundamentals/accessibility.md

Document Version Independent Id

4a0ed591-5588-df67-8630-8ae9f62bd93b

Article author

@davidbritch

Metadata

tj-devel709 commented 3 months ago

And here is the A11y Issue bringing up this point: https://github.com/dotnet/maui/issues/22906