iPad端NavigationSplitView中.topBarLeading位置ToolbarItem切换时跳动问题

问题确认 #

在iPad的NavigationSplitView中，将详情页的ToolbarItem设置为.topBarLeading位置后，点击侧边栏按钮切换其可见性时，该ToolbarItem在动画首尾阶段会出现跳动。此问题在macOS及iPadOS 18.5的UIKit替代实现中同样存在，常规的.animation、.transaction修饰符无法解决。

原生SwiftUI临时修复方案 #

由于这是框架层面的已知问题，目前可以通过以下两种临时方案缓解：

方案1：根据侧边栏状态动态调整偏移量

通过绑定侧边栏的可见性状态，给ToolbarItem添加动态偏移，抵消跳动的视觉效果：

struct ContentView: View {
    @State private var sidebarVisibility: NavigationSplitViewVisibility = .automatic

    var body: some View {
        NavigationSplitView(columnVisibility: $sidebarVisibility) {
            Color.red
                .overlay { Text("Sidebar") }
        } detail: {
            Color.green
                .toolbar {
                    ToolbarItem(placement: .topBarLeading) {
                        Text("Toolbar item")
                            // 根据侧边栏显示/隐藏状态调整水平偏移
                            .offset(x: sidebarVisibility == .detailOnly ? -8 : 0)
                            .animation(.interactiveSpring(response: 0.3, dampingFraction: 0.8), value: sidebarVisibility)
                    }
                }
        }
    }
}

方案2：自定义顶部导航栏

完全隐藏默认导航栏，自行实现顶部栏布局，彻底控制ToolbarItem的位置：

struct ContentView: View {
    @State private var sidebarVisibility: NavigationSplitViewVisibility = .automatic

    var body: some View {
        NavigationSplitView(columnVisibility: $sidebarVisibility) {
            Color.red
                .overlay { Text("Sidebar") }
        } detail: {
            ZStack(alignment: .topLeading) {
                Color.green
                
                // 自定义顶部栏，完全控制布局
                HStack(spacing: 16) {
                    Button(action: {
                        sidebarVisibility.toggle()
                    }) {
                        Image(systemName: "sidebar.left")
                            .foregroundColor(.blue)
                    }
                    Text("Toolbar item")
                    Spacer()
                }
                .padding(.horizontal, 16)
                .padding(.vertical, 12)
                .background(Color(UIColor.systemBackground))
                .shadow(radius: 1)
            }
            .toolbar(.hidden, for: .navigationBar)
            .edgesIgnoringSafeArea(.top)
        }
    }
}

是否改用UISplitViewController？ #

如果上述临时方案无法满足你的布局需求，或者需要更稳定的长期解决方案，改用UISplitViewController结合SwiftUI是可行的——通过UIViewControllerRepresentable将UISplitViewController封装到SwiftUI中，利用UIKit更成熟的分栏布局控制能力。但这种方式会增加代码复杂度，若临时修复能满足需求，优先保留原生SwiftUI实现以降低维护成本。

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