VoiceOver does not announce the role or interactivity of task items, making them appear as static text: A11y_.NET MAUI SDKs_VoiceOver
- Dominant language
- C#
- Stars
- 23.3k
- Forks
- 2k
- Avg merge
- 1d 15h
- Merged PRs (30d)
- 290
Description
## GitHub Tags:
#A11yTCS; #A11yMAS; #WCAG4.1.2; #A11ySev2; #E2E_.NET MAUI SDKs_Mac_Jul2026; #DesktopApp; #FTP; #.NET MAUI SDKs; #ScreenReader; #VoiceOver; #Device; #MAC; #a11ydb-widget-missing-role; #ALLACCTEST;
## Issue Subcategory:
Interactive element or widget missing role
## User Experience:
Assistive technology gives no indication that the element is activatable. A clickable div announced as “group” leaves users unaware they can operate it
## Repro Steps:
Turn on VoiceOver > Open Maui sample template app in Mac > Task Collection list > Navigate to any task > Observe the issue:
## Actual Result:
VoiceOver announces only the task name and does not indicate that the item is interactive. The task can still be activated using Control + Option + Space.
## Expected Result:
VoiceOver should announce the appropriate role and indicate that the task item is interactive (for example, button, link, list item with actionable state, or another suitable control type), so users understand that the item can be activated.
## How to Fix:
Use native HTML elements (``, ``, ``, etc.) whenever possible. For custom controls, add the appropriate ARIA role (e.g., `role="button"`, `role="tab"`, `role="switch"`, etc.). Verify the role against the intended UI pattern
## Environment details:
Application Name: .NET MAUI SDKs
MAC M2
## Note:
Contact [CAI Accessibility Support Channel](https://teams.microsoft.com/l/channel/19:DeCtYeREyQHw5jYsz9PPc3hpVw48m-tOlTkQ1jEn0eM1%40thread.tacv2/CAI%20Accessibility%20Support%20Channel?groupId=f5eb428c-9e6e-4c16-8143-33fe3961a9ae&tenantId=72f988bf-86f1-41af-91ab-2d7cd011db47) for Accessibility queries on design, development, test, usability or any processes
"[Check out Accessibility Insights!](https://nam06.safelinks.protection.outlook.com/?url=https://accessibilityinsights.io/&data=02%7c01%7cv-stfe%40microsoft.com%7cb67b2c4b646d4f9561a208d6f4b5c39b%7c72f988bf86f141af91ab2d7cd011db47%7c1%7c0%7c636965458850501301&sdata=mxhokIKNMb22llsjXHLgU3XZibj1Qfx37rpY4PU2sfE%3D&reserved=0) - Identify accessibility bugs before check-in and make bug fixing faster and easier."
## Attachment:
https://github.com/user-attachments/assets/5c0c702d-9c49-4539-b35d-101530c2290d
Contributor guide
Research direction
Start with the .NET MAUI sample template app's Task Collection list on Mac and reproduce the issue using VoiceOver. Trace the task item's control definition and accessibility semantics; done when VoiceOver announces an appropriate role and that the item is actionable, while activation still works.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- csharp
- Domain
- accessibility, frontend
- Issue type
- Bug
- Difficulty
- 3/5
- Estimated time
- 1-2 days
- Activity status
- Active
- Clarity
- Mostly clear
- Newbie friendliness
- 55/100