MAUI怎么为视障用户做辅助功能开发 MAUI辅助功能教程

MAUI无障碍开发关键在于正确设置控件的可访问名称、角色、状态及焦点顺序，并适配系统级无障碍设置。需用AutomationProperties.Name设语义化名称，动态更新状态，合理使用TabIndex，响应字体缩放与高对比度模式，全程结合TalkBack/VoiceOver测试。

MAUI 本身支持基础的无障碍（Accessibility）特性，但要真正为视障用户做好辅助功能开发，关键不在“有没有”，而在于“怎么设、设得对不对”。核心是让屏幕阅读器（如 TalkBack、VoiceOver）能准确识别控件类型、状态、内容，并提供有意义的操作反馈。

给控件设置可访问名称（Accessibility Name）

很多默认控件（比如 Button、Label、Image）如果没有显式设置文本或 Source，屏幕阅读器会读成“按钮”“图像”这类无意义名称。必须通过 AutomationProperties.Name 明确指定语义化名称。

• 在 XAML 中：<button automationproperties.name="提交表单" text="✓"></button>
• 在 C# 中：button.SetValue(AutomationProperties.NameProperty, "删除这条消息");
• 避免用图标+空 Text 的方式，除非同时设置了 Name；纯图标按钮一定要配 Name，否则视障用户完全不知道它干啥

标明控件类型和状态（Role & State）

MAUI 会自动推断部分 Role（如 Button 是“button”，Switch 是“switch”），但复杂自定义控件需要手动标注。状态变化（如禁用、选中、加载中）也需同步更新，否则屏幕阅读器无法感知。

• 用 AutomationProperties.HelpText 补充操作说明，例如：“双击播放音频”
• 动态更新状态：当 Switch 被切换时，确保其 IsToggled 属性已绑定或通知变更，屏幕阅读器才能读出“已开启”或“已关闭”
• 加载中的 ActivityIndicator 建议配合 AutomationProperties.IsInAccessibleTree="False" 隐藏，避免干扰；完成后恢复并提示“加载完成”（可用 Toast 或 LiveRegion）

支持焦点管理和逻辑顺序（Focus & Reading Order）

视障用户靠方向键或滑动来遍历界面，如果控件顺序混乱、不可聚焦或跳过关键元素，体验会断裂。

标签： android windows 编码 app ppt access ios switch win c# talk