presentationBackground(sheet)

在 SwiftUI 中，从 iOS 17 和 macOS 14 开始，Apple 引入了全新的 presentationBackground 修饰符，用于自定义模态呈现（例如 .sheet、.fullScreenCover、.popover 等）的背景效果，而不是使用系统默认的模糊或透明背景。下面将从多个角度详细介绍 presentationBackground 的作用、使用场景、代码示例及注意事项。

1. presentationBackground 的作用与原理 #

自定义模态背景
默认情况下，当你使用 sheet 或 fullScreenCover 弹出页面时，系统会自动生成一种背景（通常是模糊效果或半透明黑色背景），以便与呈现内容区分开。使用 presentationBackground，你可以替换这一背景，设置自己想要的颜色、渐变、图片甚至自定义视图。
提升 UI 个性化
当应用设计需要统一的视觉风格或特殊的背景效果时（例如品牌色调、主题背景或动画效果），presentationBackground 提供了极大的灵活性，让你在保持模态交互体验的同时，展现出更具个性化的风格。

2. 使用场景 #

增强视觉层次
通过自定义背景，可以使弹出视图与底层内容形成更明确的视觉分离，避免内容与背景混淆，提升可读性与聚焦感。
品牌统一性
当你希望应用中所有模态呈现页面都使用统一的背景样式（例如公司 Logo 渐变、品牌颜色等），使用 presentationBackground 能快速统一设置。
特殊交互需求
如果模态呈现需要配合动态背景（比如根据当前状态改变背景颜色或显示动画背景），presentationBackground 能够让你把这些效果放入背景视图中，从而实现更丰富的交互反馈。

3. 代码示例 #

示例 1：简单使用颜色作为背景 #

struct ContentView: View {
    @State private var showSheet = false

    var body: some View {
        Button("显示 Sheet") {
            showSheet.toggle()
        }
        .sheet(isPresented: $showSheet) {
            VStack {
                Text("这是 Sheet 内容")
                    .font(.title)
                Button("关闭") {
                    showSheet = false
                }
            }
            // 使用半透明蓝色作为背景
            .presentationBackground(Color.blue.opacity(0.3))
        }
    }
}

在这个例子中，当 Sheet 弹出时，背景会由系统默认的效果变为蓝色半透明背景。

示例 2：使用渐变背景 #

struct GradientSheetView: View {
    var body: some View {
        VStack {
            Text("渐变背景的 Sheet")
                .font(.title)
                .padding()
            Spacer()
        }
        .frame(maxHeight: .infinity)
        .presentationBackground(
            LinearGradient(
                gradient: Gradient(colors: [.purple, .pink]),
                startPoint: .top,
                endPoint: .bottom
            )
        )
    }
}

struct ContentView: View {
    @State private var showSheet = false

    var body: some View {
        Button("显示渐变 Sheet") {
            showSheet.toggle()
        }
        .sheet(isPresented: $showSheet) {
            GradientSheetView()
        }
    }
}

这里使用 LinearGradient 作为背景，能够使整个 Sheet 的背景呈现平滑的渐变效果。

示例 3：背景使用自定义视图 #

有时你可能需要更复杂的背景内容，例如带有图片、文字或动画效果的视图，这时可以直接将任意 View 作为背景：

struct CustomBackgroundView: View {
    var body: some View {
        ZStack {
            Image("backgroundImage")
                .resizable()
                .scaledToFill()
            VStack {
                Spacer()
                Text("欢迎使用自定义背景")
                    .font(.headline)
                    .foregroundColor(.white)
                    .padding(.bottom, 20)
            }
        }
        .ignoresSafeArea() // 让背景填充整个区域
    }
}

struct ContentView: View {
    @State private var showSheet = false

    var body: some View {
        Button("显示自定义背景 Sheet") {
            showSheet.toggle()
        }
        .sheet(isPresented: $showSheet) {
            VStack {
                Text("这里是内容")
                    .font(.title)
                Button("关闭") {
                    showSheet = false
                }
            }
            // 使用自定义视图作为背景
            .presentationBackground(CustomBackgroundView())
        }
    }
}

通过这种方式，你可以在背景中加入图片、文字或其他复杂布局，从而打造独一无二的视觉效果。

4. 注意事项 #

平台与版本要求
presentationBackground 是较新的 API，目前要求 iOS 17、macOS 14 及以上版本，因此在旧版本上需要采取兼容策略或降级使用系统默认背景。
与其他 Presentation 修饰符配合
通常在使用 presentationBackground 时，还会和 .presentationDetents、.presentationDragIndicator 等其他修饰符一起使用，确保整个模态呈现的行为和外观达到预期。
布局与安全区
当自定义背景视图时，注意考虑设备的安全区（Safe Area）。可以通过 .ignoresSafeArea() 来让背景视图延伸到整个屏幕，也可以根据需要保留某些边缘的安全区。
性能考量
如果背景视图内容较为复杂（例如包含动画或高分辨率图片），应注意性能优化，避免影响模态呈现的流畅性。

5. 总结 #

presentationBackground 是 SwiftUI 中专门为模态呈现自定义背景而设计的修饰符，使得开发者可以完全掌控弹出页面的背景效果。
通过使用简单的颜色、渐变、或者自定义的复杂视图，你可以为模态页面提供更加符合应用整体风格的视觉体验。
同时，与其他 presentation 相关的修饰符搭配使用，可以让整个模态呈现效果更丰富、更符合设计需求。

以上就是对 SwiftUI presentationBackground 的详细介绍和多种代码案例，希望能帮助你更好地理解和应用这一新特性。