17370845950

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

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

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

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

• 在 XAML 中：
• 在 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）

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

• 确保交互控件（Button、Entry、Switch 等）默认 IsEnabled=True 且 IsTabStop=True
• 用 TabIndex 显式控制阅读/焦点顺序（从 0 开始递增），尤其在 Grid 或自定义布局中，避免依赖视觉流
• 动态显示的控件（如弹窗、下拉菜单）出现时，应自动将焦点移入首个可操作项，并在关闭后返回原焦点位置

适配系统级无障碍设置（如大字体、高对比度）

不要硬编码字号或颜色——MAUI 提供了响应式机制，但需要主动适配。

• 用 AppThemeBinding 区分浅色/深色主题，再叠加系统高对比度模式：TextColor="{AppThemeBinding Light={StaticResource PrimaryTextColor}, Dark={StaticResource PrimaryTextColorDark}, Default={StaticResource PrimaryTextColor}}"
• 字号尽量用相对单位（如 FontSize="Body" 或 16），避免写死 FontSize="12"；启用 FontScaling 支持系统字体缩放（Android/iOS 默认支持，Windows 需确认 OS 设置）
• 测试时打开系统“放大手势”“粗体文字”“高对比度”等开关，观察布局是否错乱、文字是否截断、图标是否仍可识别

基本上就这些。MAUI 的无障碍不是加几个属性就完事，而是贯穿设计、开发、测试全流程的习惯。边写边用 TalkBack/VoiceOver 实时听一遍，比看十篇文档都管用。