Pro Max横屏时NavigationSplitView中Content工具栏Sheet无弹出动画

问题场景 #

• 应用采用NavigationSplitView三栏布局（Sidebar/Content/Detail）
• Content视图工具栏按钮和Detail视图按钮均触发同一个Sheet弹窗
• 仅iPhone Pro Max横屏状态下，点击Content工具栏按钮弹出Sheet时缺失从下往上的入场动画，关闭动画正常；其余设备、横竖屏方向均无此异常

问题原因 #

这是SwiftUI在大尺寸iPhone横屏分栏布局下的动画上下文bug：Content视图作为中间分栏，其工具栏绑定的Sheet没有正确获取到全屏动画容器，导致入场动画失效。

修复方案 #

方案一：将Sheet状态提升到全局层级 #

把Sheet的显示状态从Content视图内移到父容器（比如App层级），让Sheet绑定到全局上下文，确保动画正常触发：

import SwiftUI

@main
struct SheetShooterApp: App {
    // 全局管理Sheet显示状态
    @State private var showPatternSheet = false
    
    var body: some Scene {
        WindowGroup {
            NavigationSplitView {
                SidebarView()
            } content: {
                // 通过Binding传递状态
                ContentView(showPatternSheet: $showPatternSheet)
            } detail: {
                DetailView(showPatternSheet: $showPatternSheet)
            }
        }
    }
}

struct SidebarView: View {
    var body: some View {
        List { Text("Hello") }
    }
}

struct ContentView: View {
    @Binding var showPatternSheet: Bool
    
    var body: some View {
        List { Text("Hello, again") }
        .navigationTitle("Patterns")
        .toolbar { contentViewToolbarContent() }
        .sheet(isPresented: $showPatternSheet) { PatternSheet() }
    }
    
    @ToolbarContentBuilder func contentViewToolbarContent() -> some ToolbarContent {
        ToolbarItem(placement: .navigationBarTrailing) {
            Button { showPatternSheet = true } label: { Image(systemName: "plus") }
        }
    }
}

struct DetailView: View {
    @Binding var showPatternSheet: Bool
    
    var body: some View {
        Text("Details")
        Button("New Pattern") { showPatternSheet = true }
        .sheet(isPresented: $showPatternSheet) { PatternSheet() }
    }
}

struct PatternSheet: View {
    @Environment(\.dismiss) var dismiss
    var body: some View {
        // iOS 16+推荐使用NavigationStack替代NavigationView
        NavigationStack {
            Text("New Pattern Sheet")
                .toolbar { patternSheetToolbarContent() }
        }
    }
    
    @ToolbarContentBuilder func patternSheetToolbarContent() -> some ToolbarContent {
        ToolbarItem(placement: .navigationBarTrailing) {
            Button { dismiss() } label: { Text("Done") }
        }
    }
}

方案二：显式配置Sheet呈现参数 #

不需要修改状态层级，给Content视图的Sheet添加明确的呈现配置，强制动画上下文生效：

// 修改ContentView中的sheet修饰符：
.sheet(isPresented: $showPatternSheet) {
    PatternSheet()
        .presentationDetents([.large]) // 指定全屏尺寸
        .presentationDragIndicator(.visible) // 显示拖拽指示器
}

方案对比 #

• 方案一：统一管理Sheet状态，避免多视图重复实例化Sheet，同时彻底修复动画问题，适合复杂场景
• 方案二：代码改动最小，快速修复动画问题，适合简单场景

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