dotnet / dotnet/maui

Dashboard, Projects, and Manage Meta menu items are not accessible using keyboard navigation:A11y_.NET MAUI SDKs_Keyboard

Open
#36,972 3 comments 1 reaction 0 assignees View on GitHub
area-controls-shell partner/syncfusion platform/macos s/triaged s/verified t/a11y
Dominant language
C#
Stars
23.3k
Forks
2k
Avg merge
1d 10h
Merged PRs (30d)
297

Description

Github Tags:
#A11yTCS; #A11yMAS; #WCAG2.1.1; #A11ySev2; #E2E_.NET MAUI SDKs_Mac_Jul2026; #DesktopApp; #FTP; #.NET MAUI SDKs; #Keyboard; #Device; #MAC; #a11ydb-keyboard-unreachable; #ALLACCTEST;

## Issue Subcategory:
Interactive element cannot be reached by keyboard

## User Experience:
People primarily using a keyboard, switch, or a screen reader may not be able to move focus to the control and may not be able to perform its functionality

## Repro Steps:
Open Maui sample template app in Mac > Hemberger menu button > Observe the issue:

## Actual Result:
After opening the hamburger menu, keyboard focus lands on the Dark Theme control, and the Dashboard, Projects, and Manage Meta menu items are not accessible through keyboard navigation.

## Expected Result:
When the navigation menu is expanded using the Hamburger Menu button, keyboard focus should automatically move to the first menu item, Dashboard. Users should then be able to navigate to Projects and Manage Meta using standard keyboard navigation keys.

## How to Fix:
Prefer a control from a vetted accessible component library — and check the library's accessibility documentation to confirm it is configured correctly — which is keyboard reachable by default; otherwise use natively focusable elements (``, ``, ``); as a last resort for custom controls, add `tabindex="0"` and implement keyboard event handlers for activation

## 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/18072138-4bd1-42cb-bdf5-762f5b18df0b

Contributor guide

Open the contributing guide

Research direction

Start by running the MAUI sample template app on a Mac and reproducing the hamburger-menu focus behavior. Trace the menu implementation from the hamburger button and inspect how focus is assigned when the menu expands. Done means focus moves to Dashboard first and keyboard navigation can reach Dashboard, Projects, and Manage Meta.

Written by the indexing model from the issue text.

Assessment

Tech stack
csharp
Domain
accessibility, desktop
Issue type
Bug
Difficulty
3/5
Estimated time
1-2 days
Activity status
Active
Clarity
Mostly clear
Newbie friendliness
64/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.