SwiftUI中ScrollView内外接键盘TAB键无法切换焦点至按钮的问题

问题背景 #

设备：iPhone XR
iOS版本：18.3.2
适配要求：iOS 15.0+

开启iPhone无障碍设置中的Full Keyboard Access后，使用外接蓝牙键盘按TAB键切换焦点：

• 外层用VStack时，焦点可在2个TextField和2个按钮间正常流转
• 替换为ScrollView后，焦点被困在两个TextField之间，无法切换到按钮
• 已尝试给按钮添加.focused($focusedButton, equals: 3)/.focused($focusedButton, equals: 4)，以及使用AccessibilityFocusState，均未解决问题

解决方案 #

要让ScrollView下的按钮被TAB键正常聚焦，需同时调整焦点绑定和无障碍支持：

1. 统一焦点管理 #

给所有可聚焦控件（TextField+按钮）绑定同一个FocusState变量，明确指定每个控件的焦点标识，让系统Tab遍历按标识顺序流转。

2. 绑定无障碍焦点 #

使用AccessibilityFocusState绑定所有控件，确保Full Keyboard Access能识别按钮的可聚焦性。

修改后的完整代码 #

struct ContentView: View {
    @State private var count = 0
    @State var text1 = ""
    @State var text2 = ""
    @FocusState private var focusedElement: Int?
    @AccessibilityFocusState private var accessibilityFocusedElement: Int?
    
    var body: some View {
        ScrollView {
            VStack(spacing: 24.0) {
                Text("Btn Tap Count: \(count)")
                
                TextField("text field 1", text: $text1)
                    .textFieldStyle(RoundedBorderTextFieldStyle())
                    .focused($focusedElement, equals: 1)
                    .accessibilityFocused($accessibilityFocusedElement, equals: 1)
                
                TextField("text field 2", text: $text2)
                    .textFieldStyle(RoundedBorderTextFieldStyle())
                    .focused($focusedElement, equals: 2)
                    .accessibilityFocused($accessibilityFocusedElement, equals: 2)

                Button(action: {
                    count += 1
                }, label: {
                    Text("BTN TO Increase")
                        .padding(.vertical, 8.0)
                        .frame(maxWidth: .infinity)
                })
                .background(Color.green)
                .cornerRadius(10)
                .focused($focusedElement, equals: 3)
                .accessibilityFocused($accessibilityFocusedElement, equals: 3)

                Button(action: {
                    count -= 1
                }, label: {
                    Text("BTN TO Decrease")
                        .padding(.vertical, 8.0)
                        .frame(maxWidth: .infinity)
                })
                .background(Color.orange)
                .cornerRadius(10)
                .focused($focusedElement, equals: 4)
                .accessibilityFocused($accessibilityFocusedElement, equals: 4)
            }
            .padding(.top, 24)
            .padding()
        }
    }
}

备选方案（若上述方法无效） #

如果仍存在焦点问题，可给ScrollView添加强制包含子元素无障碍信息的修饰符：

ScrollView {
    // 子视图内容
}
.accessibilityElement(children: .contain)

原理说明 #

• FocusState负责普通焦点流转，确保所有控件处于同一遍历队列
• AccessibilityFocusState专门针对无障碍功能，让Full Keyboard Access系统正确识别按钮的可聚焦属性
• 统一的焦点标识（1→2→3→4）确保Tab键按UI布局顺序切换焦点

内容的提问来源于stack exchange，提问作者SM Abu Taher Asif