WPF自助终端应用中屏幕阅读器与虚拟键盘的无障碍适配问题

针对你提到的两个问题，我结合WPF无障碍开发的实践经验来给你梳理下解决方案：

一、屏幕阅读器朗读虚拟按键字符完全可行，体验差大概率是实现细节没做对 #

虚拟键盘搭配屏幕阅读器体验差，核心问题通常出在UI自动化属性未正确实现或者焦点/事件反馈缺失上。WPF的无障碍支持依赖UI Automation框架，自定义虚拟按键必须让屏幕阅读器能识别到按键的角色、内容和交互状态：

1. 给虚拟按键正确实现AutomationPeer
   自定义的虚拟按键控件（比如继承Button）需要重写OnCreateAutomationPeer，确保屏幕阅读器能获取到按键的名称（即按键字符）和控件类型：

   public class VirtualKeyButton : Button
   {
       protected override AutomationPeer OnCreateAutomationPeer()
       {
           return new VirtualKeyButtonAutomationPeer(this);
       }
   
       private class VirtualKeyButtonAutomationPeer : ButtonAutomationPeer
       {
           public VirtualKeyButtonAutomationPeer(VirtualKeyButton owner) : base(owner) { }
   
           protected override string GetNameCore()
           {
               // 返回按键显示的字符，比如"A"、"删除"等，让屏幕阅读器直接朗读
               return Owner.Content?.ToString() ?? string.Empty;
           }
   
           protected override AutomationControlType GetAutomationControlTypeCore()
           {
               return AutomationControlType.Button; // 告诉屏幕阅读器这是一个按钮控件
           }
       }
   }
   

2. 确保焦点与交互反馈同步

   • 当用户点击虚拟按键时，先将焦点移到该按键上（触摸屏场景下，WPF默认点击会触发焦点，但如果自定义了触摸逻辑可能需要手动设置），让屏幕阅读器先读出按键字符，再执行输入操作。
   • 输入完成后，要给目标输入框触发TextPatternTextChanged自动化事件，让屏幕阅读器感知到输入内容的变化，比如朗读当前输入框的文本：

   private void VirtualKeyButton_Click(object sender, RoutedEventArgs e)
   {
       var keyBtn = sender as VirtualKeyButton;
       var inputChar = keyBtn.Content.ToString();
       targetInputBox.Text += inputChar;
   
       // 触发输入框的文本变化自动化事件
       var inputPeer = UIElementAutomationPeer.FromElement(targetInputBox);
       inputPeer?.RaiseAutomationEvent(AutomationEvents.TextPatternTextChanged);
   }
   

3. 避免常见坑点

   • 不要用纯图标作为按键内容，必须搭配文本描述，或者通过AutomationProperties.SetName给图标按键设置朗读文本。
   • 禁止屏蔽屏幕阅读器的默认导航（比如Tab键），视障用户可能依赖键盘导航虚拟按键。

二、WPF无障碍自助终端开发的核心最佳实践 #

虽然没有专门针对自助终端的官方指南，但结合WPF无障碍规范和自助终端的场景，可以遵循以下原则：

• 焦点优先设计
  • 确保所有可交互元素（虚拟按键、功能按钮）的Tab顺序逻辑清晰，符合用户操作流程。
  • 触摸屏点击时，自动将焦点定位到被点击的元素，让屏幕阅读器即时反馈。
• 全场景的自动化属性覆盖
  • 所有自定义控件都要实现对应的AutomationPeer，明确控件类型、名称、状态（比如是否禁用）。
  • 用AutomationProperties.SetHelpText给复杂控件补充说明，比如“此按键用于清除输入框内容”。
• 输入与操作的即时反馈
  • 任何用户操作（点击按键、提交表单）都要有对应的屏幕阅读器朗读反馈，不能只依赖视觉提示。
  • 表单验证错误要通过自动化事件触发朗读，比如“输入格式错误，请重新输入”。
• 适配主流屏幕阅读器
  • 用Windows自带的Narrator快速测试基础功能，再用JAWS、NVDA等专业工具做兼容性验证。
  • 用UIA Verify工具检查UI自动化属性是否正确配置。
• 简化交互流程
  • 自助终端场景下，尽量减少操作步骤，避免复杂的层级跳转，降低视障用户的操作成本。

内容的提问来源于stack exchange，提问作者Chris Lees