macOS SwiftUI中List箭头键导航无法完整滚动的解决方案

问题场景 #

在macOS 12的SwiftUI项目中，将包含大量元素的List嵌套在NavigationView内时，使用键盘上下箭头键导航列表，仅能滚动到屏幕外的第一个元素（比如按下向下箭头仅能显示第12个元素，无法继续滚动到13及之后的内容），但鼠标滚动功能完全正常。且因兼容性要求，无法使用NavigationSplitView替代。

解决方案 #

这个问题源于macOS 12 SwiftUI的焦点管理bug，以下两种方式可修复：

方法一：显式管理List焦点

通过@FocusState控制List的焦点状态，确保NavigationView加载时焦点自动落在List上：

struct ContentView: View {
    @FocusState private var listHasFocus: Bool
    
    var body: some View {
        NavigationView {
            List {
                ForEach((1...100), id: \.self) { id in
                    NavigationLink {
                        Text("Detail View")
                    } label: {
                        Text("\(id)")
                    }
                }
            }
            .focusable()
            .focused($listHasFocus)
            .onAppear {
                listHasFocus = true
            }
        }
    }
}

方法二：用ScrollView嵌套List（备选）

如果方法一无效，可将List嵌套在ScrollView内，强制接管滚动逻辑：

struct ContentView: View {
    var body: some View {
        NavigationView {
            ScrollView {
                List {
                    ForEach((1...100), id: \.self) { id in
                        NavigationLink {
                            Text("Detail View")
                        } label: {
                            Text("\(id)")
                        }
                    }
                }
                .listStyle(.plain)
            }
        }
    }
}

原理说明 #

macOS 12的NavigationView对List的焦点传递存在异常，导致键盘导航无法触发连续滚动。方法一通过显式绑定焦点，确保List始终持有键盘焦点，正常响应箭头键的滚动指令；方法二则通过ScrollView绕过List原有的焦点问题，直接控制滚动行为。

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