SwiftUI：如何通过NavigationLink打开默认隐藏SideBar的全屏视图

核心逻辑是通过绑定侧边栏容器的显隐状态，在跳转触发时同步修改状态值，分系统版本适配如下： #

iOS 16+/macOS 13+ 原生实现方案 #

该版本起苹果使用NavigationSplitView替代旧版NavigationView，直接控制列显隐参数即可实现需求：

• 首先在根视图层声明控制列可见性的状态变量：

@State private var splitViewVisibility: NavigationSplitViewVisibility = .all

• 将变量绑定到NavigationSplitView的对应参数：

NavigationSplitView(columnVisibility: $splitViewVisibility) {
    // 侧边栏内容区
} content: {
    // 主列表内容区
} detail: {
    // 详情页内容区
}

• 在需要触发侧边栏折叠的NavigationLink对应目标视图的onAppear回调中，修改显隐状态：

NavigationLink {
    目标详情视图()
        .onAppear {
            splitViewVisibility = .detailOnly
        }
} label: {
    Text("跳转至详情页")
}

提示：如果跳转逻辑在多层子视图中，可以把splitViewVisibility通过@Binding或者ObservableObject全局状态向下传递，避免嵌套传值问题。

iOS 15及更低版本兼容方案 #

旧版本通过NavigationView的navigationViewStyle(.columns)实现侧边栏的场景，可通过修改UISplitViewController的显示模式参数实现：

• 扩展UISplitViewController适配显隐逻辑：

extension UISplitViewController {
    open override func viewWillAppear(_ animated: Bool) {
        super.viewWillAppear(animated)
        presentsWithGesture = false
        // 进入详情页时默认隐藏侧边栏
        preferredDisplayMode = .primaryHidden
    }
}

• 也可以在目标详情页的onAppear回调中，获取当前UISplitViewController实例，单独修改preferredDisplayMode属性。

常见注意点 #

• 不要在NavigationLink的label点击事件中修改显隐状态，放到目标视图的onAppear中可以避免跳转动画和侧边栏折叠动画不同步的问题
• iPad横屏场景下如果需要保留用户手动展开侧边栏的操作优先级，可以加额外状态标记，只有用户未手动修改过显隐状态时才触发默认折叠逻辑

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