dotnet / dotnet/docs-maui

SemanticProperties.Description Required for Mac Voice Control

Open
#2,442 1 comment 0 reactions 0 assignees View on GitHub
doc-enhancement dotnet-maui/subsvc dotnet-mobile/svc Pri2
Dominant language
No language data
Stars
282
Forks
265
Avg merge
2d 2h
Merged PRs (30d)
19

Description

### 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](https://github.com/user-attachments/assets/537fe8ef-2764-4ce4-b28b-30beeb2fb4bc)

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

* ID: 4a0ed591-5588-df67-8630-8ae9f62bd93b
* Service: **dotnet-mobile**
* Sub-service: **dotnet-maui**

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.