SwiftUI中TabBar可见性过渡动画实现方案

方法1：状态变量+自定义返回按钮实现平滑动画 #

不要直接使用.toolbar(.hidden, for: .tabBar)，而是通过绑定状态变量控制TabBar可见性，配合自定义返回按钮在操作前触发动画：

struct FullScreenImageView: View {
    @Binding var isTabBarHidden: Bool
    @Environment(\.dismiss) private var dismiss
    
    var body: some View {
        Image("your-screenshot")
            .resizable()
            .scaledToFit()
            .toolbar {
                ToolbarItem(placement: .navigationBarLeading) {
                    Button("返回") {
                        withAnimation {
                            isTabBarHidden = false
                        }
                        dismiss()
                    }
                }
            }
            .toolbar(isTabBarHidden ? .hidden : .visible, for: .tabBar)
            .onAppear {
                isTabBarHidden = true
            }
    }
}

// 父标签页视图调用示例
struct TabBarContainer: View {
    @State private var hideTabBar = false
    
    var body: some View {
        TabView {
            NavigationStack {
                Button("查看全屏截图") {
                    withAnimation {
                        hideTabBar = true
                    }
                }
                .navigationDestination(isPresented: $hideTabBar) {
                    FullScreenImageView(isTabBarHidden: $hideTabBar)
                }
            }
            .tabItem {
                Label("首页", systemImage: "house")
            }
        }
    }
}

核心逻辑是将TabBar可见性与状态变量绑定，进入全屏视图时通过withAnimation隐藏，返回前先执行动画恢复可见性，再触发返回操作，实现平滑过渡。

方法2：利用视图消失事件自动触发动画 #

如果不想自定义返回按钮，可在全屏视图的onDisappear回调中触发动画，无需额外修改导航按钮：

struct FullScreenImageView: View {
    @Binding var isTabBarHidden: Bool
    
    var body: some View {
        Image("your-screenshot")
            .resizable()
            .scaledToFit()
            .toolbar(isTabBarHidden ? .hidden : .visible, for: .tabBar)
            .onAppear {
                isTabBarHidden = true
            }
            .onDisappear {
                withAnimation {
                    isTabBarHidden = false
                }
            }
    }
}

系统默认返回按钮触发视图消失时，会自动执行动画恢复TabBar，无需额外操作。

方法3：桥接UIKit还原原生动画效果 #

如果SwiftUI原生方式达不到预期，可通过UIViewControllerRepresentable桥接UIKit，直接调用熟悉的原生API：

struct TabBarAnimationBridge: UIViewControllerRepresentable {
    var isHidden: Bool
    
    func makeUIViewController(context: Context) -> UIViewController {
        UIViewController()
    }
    
    func updateUIViewController(_ uiViewController: UIViewController, context: Context) {
        uiViewController.parent?.navigationController?.setToolbarHidden(isHidden, animated: true)
    }
}

// 全屏视图中使用
struct FullScreenImageView: View {
    var body: some View {
        Image("your-screenshot")
            .resizable()
            .scaledToFit()
            .background(TabBarAnimationBridge(isHidden: true))
            .onDisappear {
                TabBarAnimationBridge(isHidden: false)
            }
    }
}

这种方式直接复用UIKit的原生动画逻辑，效果和self.navigationController.setToolbarHidden(false, animated: true)完全一致。

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