SwiftUI无障碍开发：如何让VoiceOver首次打开页面时聚焦导航标题

问题分析 #

你之前在ToolbarContent内部使用@AccessibilityFocusState的方式无效，核心原因是ToolbarContent的生命周期与主视图不同步，内部状态无法正确触发焦点绑定；同时task的执行时机过早，导航栏元素可能还未完成渲染。

解决方案 #

将焦点状态移到ViewModifier层级管理，配合onAppear延迟设置焦点，确保导航栏元素已就绪：

修改后的完整代码

import SwiftUI

struct EnhancedTitleView: ToolbarContent {
    let title: String
    @Binding var isTitleFocused: Bool
    
    var body: some ToolbarContent {
        ToolbarItem(placement: .principal) {
            Text(title)
                .accessibilityFocused($isTitleFocused)
        }
    }
}

struct EnhancedTitleViewModifier: ViewModifier {
    let title: String
    @AccessibilityFocusState private var isTitleFocused: Bool

    func body(content: Content) -> some View {
        content
            .toolbar {
                EnhancedTitleView(title: title, isTitleFocused: $isTitleFocused)
            }
            .onAppear {
                // 延迟0.1秒确保导航栏元素渲染完成
                DispatchQueue.main.asyncAfter(deadline: .now() + 0.1) {
                    isTitleFocused = true
                }
            }
    }
}

extension View {
    func enhancedNavigationTitle(_ title: String) -> some View {
        modifier(EnhancedTitleViewModifier(title: title))
    }
}

// 测试视图
struct TestView: View {
    var body: some View {
        VStack {
            Text("Testing")
        }
        .enhancedNavigationTitle("Testing View")
    }
}

关键调整说明 #

1. 状态层级迁移：将@AccessibilityFocusState从ToolbarContent移到ViewModifier中，确保状态与主视图生命周期对齐，绑定关系更可靠。
2. 触发时机优化：用onAppear替代task，并添加短暂延迟，避免在导航栏元素未完全渲染时设置焦点。
3. 绑定传递：通过@Binding将ViewModifier的焦点状态传递给Toolbar中的标题视图，实现状态同步。

备选方案（兼容UIKit方式） #

如果原生SwiftUI方式仍有问题，可以直接调用UIKit的无障碍API：

struct EnhancedTitleViewModifier: ViewModifier {
    let title: String

    func body(content: Content) -> some View {
        content
            .toolbar {
                ToolbarItem(placement: .principal) {
                    Text(title)
                        .accessibilityIdentifier("navigationTitle")
                }
            }
            .onAppear {
                DispatchQueue.main.asyncAfter(deadline: .now() + 0.1) {
                    // 通过无障碍ID查找元素并设置焦点
                    if let titleElement = UIAccessibility.element(withIdentifier: "navigationTitle") {
                        UIAccessibility.post(notification: .screenChanged, argument: titleElement)
                    }
                }
            }
    }
}

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