SwiftUI中如何允许sheet后方视图正常响应用户交互

基于iOS 16+ 原生.presentationDetents实现的半屏Sheet，系统默认会在后方视图上添加UIDimmingView遮罩拦截所有触摸事件，官方暂未提供公开开关关闭该拦截，目前有两种稳定可落地的实现方案：

方案1：运行时调整遮罩层属性（推荐，无侵入兼容原生Sheet能力） #

原理：系统弹出半屏Sheet时，拦截交互的核心就是盖在presenting视图上的半透明UIDimmingView，只要在Sheet挂载后找到这层遮罩，关闭它的交互拦截属性，同时保证Sheet本身内容区域的交互正常响应，区域外的触摸事件就会自动透传给后方视图。
这个方案用到的类都是UIKit公开视图层级的类，不属于私有API，不会触发App Store审核风险，iOS 16-18版本测试均稳定。

直接复用以下代码即可：

import SwiftUI

// 用于查找父视图的扩展
extension UIView {
    func superview<T>(of type: T.Type) -> T? {
        var current = superview
        while let node = current {
            if let res = node as? T { return res }
            current = node.superview
        }
        return nil
    }
}

// 交互穿透修饰符
struct SheetBackgroundInteractionEnabled: UIViewRepresentable {
    func makeUIView(context: Context) -> UIView {
        let view = UIView()
        view.isUserInteractionEnabled = false
        DispatchQueue.main.async {
            // 找到Sheet所在的呈现容器
            guard let containerClass = NSClassFromString("UIPresentationContainerView") as? UIView.Type,
                  let container = view.superview(of: containerClass),
                  // 找到拦截交互的遮罩层
                  let dimmingView = container.subviews.first(where: { String(describing: type(of: $0)).contains("DimmingView") })
            else { return }
            // 关闭遮罩的交互拦截
            dimmingView.isUserInteractionEnabled = false
        }
        return view
    }
    
    func updateUIView(_ uiView: UIView, context: Context) {}
}

extension View {
    /// 开启半屏Sheet后方视图的交互能力
    func enableSheetBackgroundInteraction() -> some View {
        self.background(SheetBackgroundInteractionEnabled())
    }
}

使用方式非常简单，只需要在Sheet的内容根视图上调用修饰符即可，不会破坏原生Sheet的拖拽切换高度、下拉关闭等默认逻辑：

struct DemoView: View {
    @State private var showHalfSheet = false
    
    var body: some View {
        // 后方主视图的按钮、滑动手势都可以正常响应
        Button("点击弹出半屏Sheet") {
            showHalfSheet = true
        }
        .sheet(isPresented: $showHalfSheet) {
            VStack(spacing: 16) {
                Text("半屏Sheet内容区域")
                Button("Sheet内按钮") { print("点击Sheet内按钮") }
            }
            .padding(.top, 20)
            .presentationDetents([.medium, .large])
            .enableSheetBackgroundInteraction() // 只需要加这一行
        }
    }
}

方案2：自定义ZStack叠层半屏弹窗（完全可控无依赖） #

如果担心未来系统版本更新修改视图层级导致方案1失效，可以完全放弃系统原生Sheet，用ZStack自定义实现半屏弹窗：

• 用@State变量控制弹窗显隐
• 主视图和弹窗内容放在同一个ZStack下，弹窗层级盖在主视图上方
• 如果需要半透明遮罩，给遮罩设置.allowsHitTesting(false)，就不会拦截后方视图的触摸事件
• 弹窗内容只布局在需要的高度区域，自行添加拖拽手势匹配原生Sheet的高度切换、下拉关闭逻辑即可

这个方案的优点是完全不依赖系统内部视图结构，稳定性100%可控；缺点是需要自己实现转场动画、手势联动，开发量稍大。

注意：不要直接尝试修改UISheetPresentationController下presenting视图的isUserInteractionEnabled属性，系统会在Sheet弹出的生命周期里自动重置该属性，直接修改不会生效。

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