"Tags" label is not programmatically associated with its controls.: A11y_.NET MAUI SDKs_Project_Screenreader
- 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
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