dotnet / dotnet/maui

"Tags" label is not programmatically associated with its controls.: A11y_.NET MAUI SDKs_Project_Screenreader

Open
#36,941 8 comments 1 reaction 0 assignees View on GitHub
s/needs-attention t/a11y
Dominant language
C#
Stars
23.3k
Forks
2k
Avg merge
1d 10h
Merged PRs (30d)
306

Description

### Github Tags:
#A11yTCS; #A11yMAS; #WCAG1.3.1; #A11ySev2; #ScreeReader; #E2E_.NET MAUI SDKs_Win32_Jul2026; #DesktopApp; #FTP; #.NET MAUI SDKs; #InfoAndRelationships; #a11ydb-labels-not-linked; #ALLACCTEST;

### Issue Subcategory:
Labels not associated

### User Experience:
Screen reader users may not hear the label when they focus a form field, making it harder to determine the purpose of the field, and they will have to explore surrounding text to find context

### Repro Steps:
Open Maui sample template app > Project> Task> Observe the issue.

### Actual Result:
The visible "Tags" label is displayed for the associated fields; however, the label is not programmatically linked to the corresponding controls. As a result, screen readers do not announce the label when focus moves to the controls.

### Expected Result:
The "Tags" label should be programmatically associated with its corresponding field.

### How to Fix:
Prefer `` matching the `id` of the form control, or `aria-labelledby` referencing the visible label. Alternatively, the control passes if its accessible name (for example via `aria-label`) contains the visible label text, though associating the visible label is more robust and preferred.

**Similar issue also observed in below scenarios:**
Issue 1: Open Maui sample template app > Dashboard > Tasks> Tasks label is not associated.
Issue 2: Open Maui sample template app > Manage meta > Categories and Tags label are not associated.

### Environment details:
Application Name: .NET MAUI SDKs
OS: Windows 11 Enterprise Insider Preview 26300.8276

### Note:
"Please do not close this bug. This bug should only be closed by TCS, C+AI Accessibility tester after bug verification."
"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! - Identify accessibility bugs before check-in and make bug fixing faster and easier.

Attachment:

https://github.com/user-attachments/assets/d8c4e3dd-f711-4af6-8f4a-f53bc80a3446

Contributor guide

Open the contributing guide

Research direction

Start with the MAUI sample template views at Project > Task, Dashboard > Tasks, and Manage meta > Categories and Tags. Inspect how the visible labels and their controls are represented, then verify with a screen reader that each label is announced when its corresponding control receives focus.

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
68/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.