求助：CardVC在Full Keyboard Access下无法通过Tab/箭头键获取焦点

问题详情 #

• 显示CardVC且启用Full Keyboard Access时，按外接键盘的Tab或箭头键导航无法循环回到CardVC。
• 初始状态下CardVC有蓝色边框高亮（表示已聚焦），但按外接键盘的space键不会触发点击事件。预期效果：按space键应导航至账户设置。

视图层级 #

基础视图控制器（背景视图控制器）

卡片视图控制器（继承自UIViewController - 自定义高/宽，点击基础视图控制器背景可通过手势关闭）

表格视图

包含一个带有Switch Accounts按钮的单元格。

已尝试方案 #

• 在CardVC上组合设置以下属性：isAccessibilityElement = true、accessibilityViewIsModal = true、accessibilityTraits = [.keyboardKey, .allowsDirectInteraction, ...]
• 尝试焦点组及设置优先级.prioritized等，无效。
• 注释CardVC上检测背景点击的自定义手势以排除干扰，无效。
• 参考AccessibilityGroups及相关无障碍指南
• 参考苹果官方全键盘导航文档

解决建议 #

1. 修正CardVC的无障碍属性配置 #

不要直接将UIViewController标记为isAccessibilityElement = true（视图控制器本身不是视图），应把焦点绑定到CardVC的根视图上：

override func viewDidLoad() {
    super.viewDidLoad()
    view.isAccessibilityElement = true
    view.accessibilityLabel = "切换账户卡片"
    view.accessibilityTraits = [.button, .allowsDirectInteraction]
    view.accessibilityHint = "按空格键进入账户设置"
    view.accessibilityViewIsModal = true
}

2. 手动管理焦点循环 #

通过重写UIViewController的preferredFocusEnvironments指定焦点链，确保CardVC的根视图被纳入循环：

override var preferredFocusEnvironments: [UIFocusEnvironment] {
    return [view] + super.preferredFocusEnvironments
}

同时在CardVC显示时主动设置焦点：

override func viewDidAppear(_ animated: Bool) {
    super.viewDidAppear(animated)
    view.becomeFirstResponder()
    UIFocusSystem.shared.setFocusedView(view, in: self)
}

3. 直接拦截键盘事件 #

如果space键仍不响应，在CardVC的根视图中重写keyDown方法：

class CardRootView: UIView {
    var onSpacePressed: (() -> Void)?
    
    override func keyDown(with event: UIKeyEvent) {
        if event.keyCode == 49 { // 空格键对应keyCode
            onSpacePressed?()
        } else {
            super.keyDown(with: event)
        }
    }
}

在CardVC中绑定回调：

override func viewDidLoad() {
    super.viewDidLoad()
    let rootView = CardRootView(frame: view.bounds)
    rootView.onSpacePressed = { [weak self] in
        self?.navigateToAccountSettings()
    }
    view = rootView
}

4. 排除背景视图的焦点干扰 #

在背景视图控制器中，当CardVC显示时隐藏其无障碍元素：

func presentCardVC() {
    let cardVC = CardVC()
    present(cardVC, animated: true)
    view.accessibilityElementsHidden = true
}

func dismissCardVC() {
    dismiss(animated: true)
    view.accessibilityElementsHidden = false
}

5. 用Xcode调试工具定位问题 #

打开Xcode的Accessibility Inspector，检查：

• CardVC根视图的无障碍属性是否被正确识别
• 焦点路径是否包含CardVC的根视图
• 键盘事件的响应链是否传递到目标视图

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