SwiftUI中使用.fullScreenCover时自定义返回按钮的实现问题

问题根源 #

.fullScreenCover 弹出的全屏模态视图默认不属于主导航栈的层级，所以不会自动渲染导航栏——不管是默认的返回按钮还是自定义工具栏，都需要你手动在模态视图内部添加导航容器。

具体解决步骤 #

1. 在全屏模态的内容视图外层包裹 NavigationStack（iOS 16+）或 NavigationView（iOS 15及以下）
2. 通过 .toolbar 自定义返回按钮，绑定模态的展示状态变量来关闭视图
3. 不需要在主视图里设置 .navigationBarBackButtonHidden(true)，因为模态视图的导航栏是独立的

示例代码 #

假设你原来的问题代码大致如下：

struct ContentView: View {
    @State private var isPresented = false
    
    var body: some View {
        NavigationStack {
            Button("打开全屏模态") {
                isPresented = true
            }
            .fullScreenCover(isPresented: $isPresented) {
                Text("全屏模态视图")
                    .navigationBarBackButtonHidden(true)
                    .toolbar {
                        ToolbarItem(placement: .navigationBarLeading) {
                            Button("返回") {
                                isPresented = false
                            }
                        }
                    }
            }
        }
    }
}

修改后的正确代码：

struct ContentView: View {
    @State private var isPresented = false
    
    var body: some View {
        NavigationStack {
            Button("打开全屏模态") {
                isPresented = true
            }
            .fullScreenCover(isPresented: $isPresented) {
                // 关键：给模态视图添加独立的NavigationStack
                NavigationStack {
                    Text("全屏模态视图")
                        .toolbar {
                            ToolbarItem(placement: .navigationBarLeading) {
                                Button("返回") {
                                    isPresented = false
                                }
                            }
                        }
                }
            }
        }
    }
}

额外说明 #

• 如果想要保留系统默认的关闭按钮（通常显示为"Done"），无需自定义ToolbarItem，只要模态视图嵌套在NavigationStack内，默认工具栏会自动出现，点击后会自动关闭模态
• 若要替换默认按钮，直接添加自定义ToolbarItem即可覆盖默认样式

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