SwiftUI Full Keyboard Access自定义焦点样式及模拟器测试问题

自定义Full Keyboard Access下的焦点样式 #

Full Keyboard Access（全键盘访问）的焦点系统与UIKit原生Focus Engine完全打通，你可以通过以下方式自定义焦点外观，实现类似accessibilityPath的形状匹配效果：

• iOS 14及以上版本方案：重写控件的focusEffect属性，直接创建自定义UIFocusHaloEffect，可以自定义路径、圆角、边框、填充色，完全替换系统默认的蓝色背景样式：

  override var focusEffect: UIFocusEffect? {
      get {
          // 替换为你需要的自定义路径，和accessibilityPath保持一致即可
          let customPath = UIBezierPath(roundedRect: bounds.insetBy(dx: 2, dy: 2), cornerRadius: 8)
          let haloEffect = UIFocusHaloEffect(path: customPath)
          haloEffect.cornerRadius = 8
          haloEffect.borderWidth = 2
          haloEffect.borderColor = .systemBlue
          haloEffect.fillColor = .clear // 禁用系统默认的蓝色填充背景
          return haloEffect
      }
      set {}
  }
  

  同时给控件设置accessibilityPath属性，保证其他辅助功能（如旁白）可以识别正确的可交互区域：

  override var accessibilityPath: UIBezierPath? {
      get { UIBezierPath(roundedRect: bounds.insetBy(dx: 2, dy: 2), cornerRadius: 8) }
      set {}
  }
  

• iOS 13兼容方案：iOS 13没有提供UIFocusHaloEffectAPI，你需要监听UIAccessibility.focusedElementDidChangeNotification通知，判断当前聚焦元素是否为你的自定义控件，手动添加/移除自定义焦点视图。如果要完全禁用系统默认焦点样式，直接将focusEffect返回nil即可。

Xcode 12/13模拟器测试Full Keyboard Access的解决方案 #

Xcode 12、13搭载的iOS 13~15版本模拟器存在已知的Full Keyboard Access兼容bug，开启后无响应是系统层面的问题，和你的操作或代码无关。无实体设备的测试方案如下：

• 方案1：并行安装Xcode 14及以上版本，使用iOS 16及以上版本的模拟器。苹果在iOS 16的模拟器中完整修复了全键盘访问的支持问题，开启路径为「设置 > 辅助功能 > 键盘 > 全键盘访问」，开启后即可通过Tab、方向键、空格等按键模拟实体键盘的导航操作。高版本模拟器的测试结果可覆盖功能逻辑验证，只要你的代码兼容iOS 13的API要求，不会出现版本兼容偏差。
• 方案2：如果暂时无法升级Xcode，可先通过测试原生Focus Engine的逻辑间接验证全键盘访问逻辑：打开模拟器顶部菜单「Debug > Focus > Log Focus Events」，通过触控操作触发焦点切换，其触发逻辑和全键盘访问的焦点逻辑完全一致，可先完成功能开发，后续在实体设备或高版本模拟器做最终验证即可。

内容的提问来源于stack exchange，提问作者Numan Tariq