NavigationSplitView无List时iPhone无法跳转详情（iPad正常）

问题根源 #

NavigationSplitView在不同设备上的行为逻辑存在差异：

• iPad默认是分栏模式，只要传递选中项就能直接更新详情栏；
• iPhone默认是堆叠模式（折叠成导航栈），需要触发导航栈的push操作。

List配合selection绑定的时候，SwiftUI内部自动适配了两种模式的逻辑：在iPhone上会自动将选中操作转化为导航push，在iPad上更新分栏详情。但自定义视图（比如单独的Button）没有这种内置适配，所以iPhone上无法触发跳转。

解决方案1：绑定selection状态（推荐） #

通过手动绑定selection变量，让NavigationSplitView自行处理两种模式的导航逻辑：

struct CustomSplitView: View {
    let items = ["Item 1", "Item 2", "Item 3"]
    @State private var selectedItem: String? // 定义选中状态变量
    
    var body: some View {
        NavigationSplitView(selection: $selectedItem) {
            // 自定义内容视图，无需List
            VStack(spacing: 12) {
                ForEach(items, id: \.self) { item in
                    Button(action: {
                        selectedItem = item // 点击更新选中状态
                    }) {
                        HStack {
                            Text(item)
                                .frame(maxWidth: .infinity, alignment: .leading)
                            Spacer()
                        }
                        .padding(.horizontal)
                    }
                    .buttonStyle(.borderless) // 可选：模拟List行的点击样式
                }
            }
            .navigationTitle("Items")
        } detail: {
            if let selectedItem {
                Text("Detail View for \(selectedItem)")
                    .navigationTitle(selectedItem)
            } else {
                Text("Select an item to view details")
            }
        }
    }
}

解决方案2：嵌套NavigationStack（手动管理导航） #

如果不想依赖selection绑定，可以在自定义视图中嵌套NavigationStack，手动处理导航栈：

struct CustomSplitView: View {
    let items = ["Item 1", "Item 2", "Item 3"]
    
    var body: some View {
        NavigationSplitView {
            NavigationStack {
                VStack(spacing: 12) {
                    ForEach(items, id: \.self) { item in
                        NavigationLink(item, value: item)
                    }
                }
                .navigationTitle("Items")
                .navigationDestination(for: String.self) { selectedItem in
                    Text("Detail View for \(selectedItem)")
                        .navigationTitle(selectedItem)
                }
            }
        } detail: {
            Text("Select an item to view details")
        }
    }
}

注意：这种方式在iPad上可能同时显示分栏和导航栈，如需统一体验，建议结合@Environment(\.horizontalSizeClass)判断设备类型，动态调整布局。

关键总结 #

• List的selection绑定并非必须，但它帮我们封装了跨设备的导航逻辑；
• 自定义视图需要通过selection绑定或手动嵌套NavigationStack，来适配iPhone的堆叠模式导航；
• 推荐使用selection绑定的方式，代码更简洁且跨设备行为统一。

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