如何在Overlay显示时禁用主UI，仅让Overlay响应Voiceover操作？

嘿，这个场景我在做音频类应用时也遇到过！核心问题是VoiceOver会遍历整个视图层级的可访问元素，哪怕你的Overlay在视觉上盖住了主UI，底层控件依然在无障碍队列里。下面给你几个实用的解决方案，按需选择：

方案1：通过容器的accessibilityElementsHidden快速禁用主UI #

这是最简洁的方法，前提是你把主UI的所有控件都放在一个统一的容器视图里（比如mainContentContainerView）。当Overlay显示时，直接隐藏这个容器的所有无障碍元素：

// 音频流中断，显示Overlay时
mainContentContainerView.accessibilityElementsHidden = true

// 音频恢复，隐藏Overlay时
mainContentContainerView.accessibilityElementsHidden = false

这个属性会递归作用于容器内的所有子视图，一键让VoiceOver忽略整个主UI区域，非常高效。如果你的主UI还没有统一容器，建议重构一下，后续维护也更方便。

方案2：用accessibilityViewIsModal让Overlay成为无障碍模态层（iOS 13+） #

iOS 13之后新增了accessibilityViewIsModal属性，设置为true后，VoiceOver会只关注当前视图及其子元素，自动忽略其他层级的内容。适合你的Overlay是全屏覆盖的场景：

// 初始化Overlay视图时
overlayView.accessibilityViewIsModal = true

// 显示Overlay时，确保这个属性生效（如果是动态创建的Overlay，显示时设置也可以）
overlayView.accessibilityViewIsModal = true

// 隐藏Overlay时重置
overlayView.accessibilityViewIsModal = false

注意：这个属性需要Overlay视图是整个屏幕的层级（比如添加到UIWindow或者根控制器的view上），否则可能达不到预期效果。同时别忘了给Overlay内的控件设置正确的无障碍标签（accessibilityLabel）和提示（accessibilityHint），让用户能清晰了解操作。

方案3：逐个禁用主UI控件的无障碍属性（不推荐，仅作备选） #

如果因为架构限制没法用容器或模态属性，只能逐个处理主UI的可交互控件。可以写一个递归方法遍历所有控件，切换它们的isAccessibilityElement状态：

private func toggleMainUIAccessibility(enabled: Bool) {
    func updateAccessibility(for view: UIView) {
        // 针对UIControl子类（按钮、滑块等可交互控件）处理
        if let control = view as? UIControl {
            control.isAccessibilityElement = enabled
        }
        // 递归处理子视图
        view.subviews.forEach(updateAccessibility)
    }
    updateAccessibility(for: self.view) // 传入主UI的根视图
}

// 使用：显示Overlay时调用toggleMainUIAccessibility(enabled: false)
// 恢复时调用toggleMainUIAccessibility(enabled: true)

这个方法比较繁琐，控件多的时候容易遗漏，所以优先推荐前两种方案。

额外测试提示 #

一定要用真实设备开启VoiceOver测试，模拟器的无障碍功能有时候会有延迟或不准确的情况。测试时记得验证：

• Overlay显示时，滑动VoiceOver焦点是否只会停留在Overlay的控件上
• 音频恢复后，主UI的控件是否能正常被VoiceOver选中

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