CommunityToolkit / CommunityToolkit/Maui

[BUG] [Android] Popup V2 - Accessibility: screen reader focus issue

Open
#2,865 7 comments 0 reactions 0 assignees View on GitHub
bug unverified
Dominant language
C#
Stars
2.7k
Forks
500
Avg merge
2d 14h
Merged PRs (30d)
7

Description

### Is there an existing issue for this?

- [x] I have searched the existing issues

### Did you read the "Reporting a bug" section on Contributing file?

- [x] I have read the "Reporting a bug" section on Contributing file: https://github.com/CommunityToolkit/Maui/blob/main/CONTRIBUTING.md#reporting-a-bug

### Current Behavior

On Android, when TalkBack or a screen reader is enabled and a popup opens, the screen reader's focus is placed on the general popup window, reading all the text and semantic properties, but it does not allow you to focus on individual elements of the pop-up, only on the buttons or `Entry` for example.

https://github.com/user-attachments/assets/0b6e33a0-c761-4ac9-a6a2-4f10dcaa6ee1

### Expected Behavior

Be able to click or navigate through the elements of the popup with the screen reader, just like in iOS.

### Steps To Reproduce

1. Enable TalkBack or the screen reader in an Android phone.
2. Open the app from the repro project.
3. Click to open any of the popups.
4. Try to click any content of the popup to focus the screen reader.
5. Try to click the buttons or the Entry of the popup to focus the screen reader.

### Link to public reproduction project repository

https://github.com/FabriBertani/PopupV2TalkBackBugRepro

### Environment

```markdown
- .NET MAUI CommunityToolkit: 12.2.0
- OS: Windows 11, Mac OS 15.6
- .NET MAUI: 9.0.90
```

### Anything else?

I believe this is related to the fact that the new popups are actually a `ContentPage` navigated as a modal, which is why the screen reader tends to focus on the entire screen rather than the popup contents.

Contributor guide

Open the contributing guide

Research direction

Start with the linked PopupV2TalkBackBugRepro project and reproduce the behavior on Android with TalkBack enabled. Trace the Popup V2 ContentPage modal flow, compare its focus behavior with iOS, and verify that individual popup elements can be navigated and focused rather than only the window, buttons, or Entry.

Written by the indexing model from the issue text.

Assessment

Tech stack
android, csharp
Domain
accessibility, mobile-dev
Issue type
Bug
Difficulty
4/5
Estimated time
3-5 days
Activity status
Quiet
Clarity
Mostly clear
Newbie friendliness
48/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.