dotnet / dotnet/maui

VoiceOver does not announce the role or interactivity of task items, making them appear as static text: A11y_.NET MAUI SDKs_VoiceOver

Open
#37,140 3 comments 1 reaction 0 assignees View on GitHub
area-controls-general partner/syncfusion platform/macos s/triaged s/verified
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

Open the contributing 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

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.