maui-accessibility

Guide .NET MAUI developers to implement screen reader support with semantic properties.

Updated Dec 25, 2025
One-click install
npx skills add https://github.com/heldercsousa/MyVocaList --skill maui-accessibility-heldercsousa
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: maui-accessibility
Source: https://github.com/heldercsousa/MyVocaList/tree/main/.claude/skills/maui-accessibility
Command: npx skills add https://github.com/heldercsousa/MyVocaList --skill maui-accessibility-heldercsousa

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Make .NET MAUI accessibility easier by providing a comprehensive guide to screen reader support, semantics, and platform-specific considerations.

Core Features & Use Cases

  • SemanticProperties (Description, Hint, HeadingLevel) usage on VisualElement to convey context to screen readers.
  • Programmatic focus & announcements with SetSemanticFocus and SemanticScreenReader.Announce.
  • AutomationProperties controls to manage accessibility visibility and compatibility across platforms.
  • Cross-platform gotchas and best practices for TalkBack, VoiceOver, and Narrator.

Quick Start

Use SemanticProperties and AutomationProperties on VisualElements in your MAUI app, then validate with TalkBack, VoiceOver, and Narrator.

Frequently Asked Questions about maui-accessibility

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I add screen reader support to a .NET MAUI app?

To add screen reader support in .NET MAUI, apply SemanticProperties like Description and Hint to VisualElements, use AutomationProperties to manage visibility, and validate behavior across TalkBack, VoiceOver, and Narrator.

Does .NET MAUI work with TalkBack, VoiceOver, and Narrator for accessibility?

Yes, .NET MAUI supports cross-platform accessibility for TalkBack, VoiceOver, and Narrator, though developers must apply platform-specific best practices and navigate known gotchas to ensure proper screen reader focus and semantic behavior.

How do I set heading levels for screen readers in MAUI?

Set heading levels in MAUI by applying the SemanticProperties.HeadingLevel attribute to your VisualElements, allowing screen readers to correctly convey content hierarchy and navigation structure to users.

Can I programmatically set semantic focus and announce text in a MAUI app?

Yes, you can programmatically control screen reader focus using SetSemanticFocus and trigger text announcements using SemanticScreenReader.Announce within your .NET MAUI application.

Why is my MAUI screen reader ignoring hidden or visually collapsed elements?

Screen readers may ignore hidden elements if accessibility visibility is not properly configured. Use AutomationProperties in MAUI to explicitly manage whether visually collapsed elements are exposed to screen readers across different platforms.

What are common cross-platform accessibility gotchas in .NET MAUI?

Common .NET MAUI accessibility gotchas involve platform-specific behavior differences across TalkBack, VoiceOver, and Narrator, requiring careful management of semantic properties, focus order, and element visibility to ensure consistent screen reader experiences.