SwiftUI中accessibilityViewIsModal的使用方法及焦点切换问题

我曾在UIKit中使用accessibilityViewIsModal = true来将无障碍焦点从一个视图切换到子视图，现在想知道在SwiftUI中该如何实现？

我尝试了两种方法切换无障碍焦点，但都没成功：

• 使用UIAccessibility.post(notification: .screenChanged, argument: "New Screen appear")，结果无障碍焦点未发生变化
• 直接设置accessibilityViewIsModal = true，结果编译报错：Cannot find 'accessibilityViewIsModal' in scope

我的代码如下：

if showSelectPolicyView {
    SelectPolicyView(input: $inputData, showSelectPolicyView: $showSelectPolicyView)
        .transition(.move(edge: .bottom))
        .clipped()
        .zIndex(1)
        .background(Color.gray)
        .onAppear {
            accessibilityViewIsModal = true
        }.onDisappear() {
            accessibilityViewIsModal = true
        }
}

请问在SwiftUI中应该在哪里、如何使用accessibilityViewIsModal？

解决方法 #

在SwiftUI中，accessibilityViewIsModal是通过视图修饰符来设置的，而非像UIKit那样直接赋值属性。你需要用.accessibilityViewIsModal(_:)修饰符为目标视图开启模态无障碍特性，同时结合正确的焦点通知引导无障碍焦点。

1. 正确设置accessibilityViewIsModal修饰符 #

将修饰符直接附加到弹窗视图上，而非在onAppear中赋值：

if showSelectPolicyView {
    SelectPolicyView(input: $inputData, showSelectPolicyView: $showSelectPolicyView)
        .transition(.move(edge: .bottom))
        .clipped()
        .zIndex(1)
        .background(Color.gray)
        // 开启模态无障碍视图特性
        .accessibilityViewIsModal(true)
        .onAppear {
            // 弹窗出现时，将无障碍焦点切换到模态视图
            UIAccessibility.post(notification: .screenChanged, argument: nil)
        }
        .onDisappear {
            // 弹窗消失时，将焦点切回原视图层级
            UIAccessibility.post(notification: .screenChanged, argument: nil)
        }
}

2. 优化焦点通知参数 #

之前用字符串作为screenChanged的参数无法正确定位焦点，正确用法：

• 若想让焦点直接落到弹窗内的某个子视图，可将该子视图的AccessibilityElement作为参数传入
• 无需指定具体子视图时，传nil即可，系统会自动将焦点切换到模态视图的根元素

3. 额外注意事项 #

• 确保SelectPolicyView内部的关键交互元素（如按钮、核心文本）配置了合适的accessibilityLabel，保证无障碍识别准确
• 模态视图需保持足够的层级优先级（如你设置的zIndex(1)），确保无障碍系统能识别它是当前最上层的交互视图

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