如何阻止SwiftUI TabView使用Voiceover导航时重置至首页？

这不是Bug，是SwiftUI PageTabView默认的辅助功能交互逻辑导致的冲突。当Voiceover通过点标滑动导航时，分页指示器的辅助事件会意外触发选中状态重置，导致页面跳回第0页。

解决方法 #

可以通过以下两种方式修复：

方法1：自定义分页指示器并禁用默认指示器的辅助功能

隐藏默认分页指示器，自定义一个符合Voiceover交互逻辑的指示器，避免默认行为的冲突：

import SwiftUI

struct ContentView: View {
    @State var tab: Int = 0
    let pageCount = 3
    
    var body: some View {
        ZStack(alignment: .bottom) {
            TabView(selection: $tab) {
                VStack {
                    Text("第0页")
                }
                .tag(0)
                .accessibilityLabel("第0页")
                
                VStack {
                    Text("第1页")
                }
                .tag(1)
                .accessibilityLabel("第1页")
                
                VStack {
                    Text("第2页")
                }
                .tag(2)
                .accessibilityLabel("第2页")
            }
            .tabViewStyle(.page(indexDisplayMode: .never)) // 隐藏默认指示器
            
            // 自定义分页指示器
            HStack(spacing: 8) {
                ForEach(0..<pageCount, id: \.self) { index in
                    Circle()
                        .fill(index == tab ? Color.blue : Color.gray)
                        .frame(width: 8, height: 8)
                        .accessibilityLabel(index == tab ? "当前页，第\(index)页" : "第\(index)页")
                        .onTapGesture {
                            tab = index
                        }
                }
            }
            .padding(.bottom, 20)
        }
    }
}

方法2：修复默认TabView的辅助功能响应

通过监听选中状态变化，并添加accessibilityScrollAction手动处理Voiceover的滑动导航，确保状态正确同步：

import SwiftUI

struct ContentView: View {
    @State var tab: Int = 0
    let pageCount = 3
    
    var body: some View {
        TabView(selection: $tab) {
            VStack {
                Text("第0页")
            }
            .tag(0)
            
            VStack {
                Text("第1页")
            }
            .tag(1)
            
            VStack {
                Text("第2页")
            }
            .tag(2)
        }
        .tabViewStyle(.page)
        .accessibilityScrollAction(.up) {
            if tab < pageCount - 1 {
                tab += 1
            }
        }
        .accessibilityScrollAction(.down) {
            if tab > 0 {
                tab -= 1
            }
        }
        .onChange(of: tab) { _ in
            // 通知Voiceover界面布局更新，确保焦点正确同步
            UIAccessibility.post(notification: .layoutChanged, argument: nil)
        }
    }
}

原理说明 #

默认的PageTabView分页指示器在Voiceover模式下，其辅助事件会和绑定的selection状态产生冲突，导致滑动导航时触发错误的状态重置。上述方法要么替换默认指示器，要么手动接管Voiceover的滑动导航逻辑，从而避免冲突。

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