Full Screen Cover：什么是全屏覆盖、全屏展示和 UIKit

什么是 iOS 中的 Full Screen Cover？

Full Screen Cover — 是 iOS 中的一种模态展示风格，被展示的控制器占据设备的整个屏幕。父级内容被完全隐藏，营造沉浸式效果，使用户专注于当前任务。

在 iOS 13 之前，Full Screen Cover 是 iPhone 上唯一的模态展示风格。所有 present(_:animated:completion:) 调用默认使用 .fullScreen。从 iOS 13 开始，Apple 将默认风格改为 .automatic，对于 iPhone 选择 .pageSheet。然而，Full Screen Cover 仍然可用，并用于需要完全专注的场景。

与 Page Sheet 不同，Full Screen Cover 不允许与父级内容交互，也不在模态窗口下方显示父级内容。用户无法通过向下滑动来关闭 Full Screen Cover — 关闭需要程序化调用 dismiss(animated:completion:) 或屏幕本身的关闭按钮。这种在设计 UX 时需要重要考虑。

Full Screen Cover vs Page Sheet：风格对比

Page Sheet — 第二种主要模态展示风格，在 iOS 13 中出现。Page Sheet 以卡片形式显示，顶部有间距，下方可看到父级屏幕。用户可以通过向下滑动关闭 Page Sheet。Full Screen Cover 则相反，隐藏父级内容且不支持滑动关闭。

选择 Full Screen Cover 还是 Page Sheet 取决于内容和上下文。建议对需要完全注意力的内容使用 Full Screen Cover：全屏模式视频、照片预览、文档扫描。Page Sheet — 用于父级屏幕上下文重要的任务：编辑表单、选项选择、查看详情。

在 UIKit 中实现：UIModalPresentationStyle

UIKit 提供 UIModalPresentationStyle.fullScreen 常量用于配置模态展示风格。在调用 present 之前在 UIViewController 上设置此属性可确保控制器全屏显示。控制器还管理键盘出现时的行为和系统事件的处理。

配置和代理

设置 .fullScreen 风格后，建议配置 presentationController?.delegate 来处理关闭事件。UIAdaptivePresentationControllerDelegate 代理允许拦截关闭尝试并防止数据丢失。与 Page Sheet 不同，对于 Full Screen Cover，代理仅在程序化 dismiss 调用时触发。

处理旋转和键盘

Full Screen Cover 正确处理屏幕旋转和键盘出现。旋转时，模态控制器自动适应新方向。UIKeyboardWillShowNotification 允许在键盘出现时将内容上移，使文本字段保持可见。与 Page Sheet 不同，Full Screen Cover 在键盘出现时不改变尺寸。

let playerVC = VideoPlayerViewController()
playerVC.modalPresentationStyle = .fullScreen
playerVC.modalTransitionStyle = .crossDissolve
present(playerVC, animated: true) {
    playerVC.startPlayback()
}

// 关闭
dismiss(animated: true) {
    print("播放器已关闭")
}

SwiftUI：.fullScreenCover 修饰符

SwiftUI 提供 .fullScreenCover 修饰符用于声明式创建全屏模态窗口。与 .sheet（Page Sheet）不同，.fullScreenCover 创建 .fullScreen 风格，行为类似：完全覆盖内容且不支持滑动关闭。

使用 binding 和数据

修饰符接受 Bool 类型的 binding 或可选的可识别对象。当 binding 设置为 true 时，SwiftUI 动画显示全屏窗口。数据传递使用 onDismiss 参数和包含内容的闭包。环境值 \.dismiss 允许从内部关闭模态窗口。

Full Screen Cover vs Sheet

在 SwiftUI 中选择 .fullScreenCover 和 .sheet 类似于 UIKit：.fullScreenCover 用于沉浸式内容，.sheet 用于卡片。SwiftUI 自动选择正确的关闭行为：.sheet 可以通过滑动关闭，.fullScreenCover — 只能程序化关闭。修饰符可以在同一 View 层次结构中组合使用。

struct CameraView: View {
    @State private var showCamera = false

    var body: some View {
        Button("打开相机") {
            showCamera = true
        }
        .fullScreenCover(isPresented: $showCamera) {
            CameraPreviewView()
                .ignoresSafeArea()
        }
    }
}

struct CameraPreviewView: View {
    @Environment(\.dismiss) private var dismiss

    var body: some View {
        ZStack {
            Color.black.ignoresSafeArea()
            VStack {
                Spacer()
                Button("拍摄") { dismiss() }
                    .foregroundColor(.white)
            }
        }
    }
}

自定义动画和过渡

Full Screen Cover 支持通过 UIModalTransitionStyle 在 UIKit 中实现自定义动画，以及在 SwiftUI 中实现自定义过渡。标准样式：.coverVertical（从下往上）、.crossDissolve（逐渐显示）、.flipHorizontal（翻转）和 .partialCurl（翻页效果）。

UIKit：UIViewControllerAnimatedTransitioning

对于完全自定义动画，实现 UIViewControllerAnimatedTransitioning 协议。它允许通过 animateTransition(using:) 方法定义动画持续时间和过渡本身。动画控制器通过 UINavigationControllerDelegate 或 UIViewControllerTransitioningDelegate 代理指定。

SwiftUI：匹配几何效果

在 SwiftUI 中，.fullScreenCover 的自定义过渡通过 matchedGeometryEffect 创建。此修饰符动画化元素从父级 View 到全屏窗口的移动。例如，点击照片缩略图时，它会平滑展开到全屏，产生连续性效果。MatchedGeometryEffect 使用 id 和 namespace，将元素在源位置和目标位置连接起来。

struct PhotoViewer: View {
    @State private var selectedPhoto: String?
    @Namespace private var animation

    var body: some View {
        HStack {
            ForEach(["photo1", "photo2"], id: \.self) { photo in
                Image(photo)
                    .matchedGeometryEffect(id: photo, in: animation)
                    .onTapGesture { selectedPhoto = photo }
            }
        }
        .fullScreenCover(item: $selectedPhoto) { photo in
            Image(photo)
                .matchedGeometryEffect(id: photo, in: animation)
                .ignoresSafeArea()
        }
    }
}

何时使用 Full Screen Cover？

Full Screen Cover 建议用于内容应占据整个屏幕而不受父级界面干扰的场景。Apple HIG 区分了三个主要类别：媒体内容、内容创建工具和临时系统界面。

媒体和娱乐

视频播放器、照片查看、阅读 PDF 和漫画 — Full Screen Cover 的典型使用示例。AVPlayerViewController 在 iOS 中切换到横屏时自动使用全屏模式。Adobe Lightroom 等照片编辑器在图像库上方打开全屏编辑器。

内容创建工具

相机、文档扫描仪、录音 — 需要用户全神贯注的任务。UIImagePickerController 在 iOS 14 之前对相机使用 Full Screen Cover。从 iOS 14 开始，系统选择器使用 Page Sheet，但开发人员可以为自定义相机强制设置 .fullScreen。

需要避免的情况

不要对以下情况使用 Full Screen Cover：注册表单（优先选择 Page Sheet）、父级页面上下文重要的文本输入屏幕以及模态窗口内的连续导航。Material Design 也建议避免阻止系统返回按钮 — 在 iOS 中这是允许的，但用户应该通过界面元素有明确的关闭方式。