tvOS中NavigationSplitView异常：仅显示侧边栏不展示详情列

问题根源 #

tvOS上的NavigationSplitView交互逻辑和iOS/macOS存在差异：

• 详情列默认仅在侧边栏有选中内容（通过selection绑定或NavigationLink触发）时才会渲染。
• 你只设置了columnVisibility: .constant(.doubleColumn)，但侧边栏只是纯颜色视图，没有任何触发详情展示的状态或交互，系统会判定没有可展示的详情内容，因此仅显示侧边栏。

修复方案 #

方案1：通过选中状态绑定强制展示详情

给侧边栏设置默认选中项，让系统识别到有详情内容需要展示：

struct ListViewDetails: View {
    @State private var selectedItem: String? = "默认"
    
    var body: some View {
        NavigationSplitView(columnVisibility: .constant(.doubleColumn)) {
            List(selection: $selectedItem) {
                Text("默认选项").tag("默认")
            }
            .background(Color.blue)
        } detail: {
            Color.red
                .overlay(Text("详情列"))
        }
    }
}

方案2：用NavigationLink触发详情列

在侧边栏添加NavigationLink，当焦点移至链接时，详情列会自动显示：

struct ListViewDetails: View {
    var body: some View {
        NavigationSplitView(columnVisibility: .constant(.doubleColumn)) {
            NavigationLink("查看详情") {
                EmptyView()
            }
            .background(Color.blue)
        } detail: {
            Color.red
                .overlay(Text("详情列"))
        }
    }
}

额外说明 #

• 确保项目部署目标为tvOS 16.0及以上，NavigationSplitView从该版本开始支持。
• tvOS的NavigationSplitView设计适配遥控器操作逻辑，依赖焦点或选中状态来控制详情列的显示，这是平台特性而非代码错误。

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