SwiftUI中Sheet动画缺失：如何统一弹窗过渡效果？

在部分页面中使用.sheet弹出视图时，下方的原视图会出现轻微下移及宽度收缩的过渡动画（这是Sheet的默认行为），但导航到其他页面后，使用完全相同的代码弹出Sheet却没有这个效果，请问如何实现该动画？

当前使用的Sheet代码：

.sheet(isPresented: $showPopView) {
    DetailsView(
        viewModel: viewModel.detailsViewModel
    )
}

解决思路与方案 #

这种动画差异通常是因为页面的视图层级或导航环境不同导致的，比如是否处于标准导航容器内、是否修改了系统动画环境等。以下是具体的解决方法：

1. 还原标准导航环境 #

系统Sheet的默认收缩下移动画，只有在视图处于NavigationStack（iOS 16+）或NavigationView（iOS 15及以下）容器内时才会自动触发。如果无动画的页面未被导航容器包裹，直接将其放入导航容器即可恢复默认效果：

// iOS 16+ 用NavigationStack
NavigationStack {
    YourTargetPageView()
        .sheet(isPresented: $showPopView) {
            DetailsView(viewModel: viewModel.detailsViewModel)
        }
}

// iOS 15及以下 用NavigationView
NavigationView {
    YourTargetPageView()
        .sheet(isPresented: $showPopView) {
            DetailsView(viewModel: viewModel.detailsViewModel)
        }
}

2. 手动模拟系统动画效果 #

如果无法依赖导航容器，可以通过给原视图添加动画修饰器，手动模拟Sheet弹出时的收缩下移效果：

YourTargetPageView()
    // 缩放+下移模拟系统动画
    .scaleEffect(showPopView ? 0.95 : 1.0)
    .offset(y: showPopView ? 20 : 0)
    // 匹配系统动画的缓动曲线及时长
    .animation(.easeInOut(duration: 0.3), value: showPopView)
    .sheet(isPresented: $showPopView) {
        DetailsView(viewModel: viewModel.detailsViewModel)
    }

• 可根据视觉需求微调scaleEffect的缩放比例和offset的Y偏移量，让效果更贴近系统默认动画
• 动画时长设为0.3秒左右，和系统Sheet的动画周期保持一致

3. 检查并恢复系统动画环境 #

如果页面中存在禁用全局动画的设置（比如.animation(nil)或withAnimation(nil)），会导致Sheet的默认动画失效。需要移除这类设置，或者仅针对特定状态禁用动画，保留Sheet相关的动画逻辑：

// 错误示例：禁用了全局动画，会影响Sheet默认效果
YourTargetPageView()
    .animation(nil, value: someState)

// 修复方式：移除全局禁用动画的代码，或仅针对特定值控制动画
YourTargetPageView()
    .animation(someState ? .easeInOut : nil, value: someState)

内容的提问来源于stack exchange，提问作者New iOS Dev