SwiftUI中Sheet内TabView嵌套ScrollView致下拉关闭失效问题

Sheet的下拉关闭手势会被内部ScrollView的垂直滚动手势拦截，导致无法通过下拉关闭Sheet，同时ScrollView和TabView的滚动功能需要保留。以下是几种可行的解决方案：

方案1：调整ScrollView手势优先级（推荐） #

通过自定义UIGestureRecognizerDelegate，让Sheet的下拉手势在ScrollView处于顶部时优先响应：

struct ContentView: View {
    @State private var sheetPresented = true
    
    var body: some View {
        VStack {}
            .sheet(isPresented: $sheetPresented) {
                TabView {
                    ScrollView(.vertical) {
                        ForEach(0..<100) { i in
                            Text("Item \(i)")
                                .containerRelativeFrame(.horizontal)
                        }
                    }
                    .tag(0)
                    .onAppear {
                        setupScrollViewGesture()
                    }
                    
                    ScrollView(.vertical) {
                        ForEach(0..<100) { i in
                            Text("Item \(i)")
                                .containerRelativeFrame(.horizontal)
                        }
                    }
                    .tag(1)
                    .onAppear {
                        setupScrollViewGesture()
                    }
                }
                .tabViewStyle(.page(indexDisplayMode: .never))
            }
    }
    
    private func setupScrollViewGesture() {
        UITableView.appearance().gestureRecognizers?.forEach {
            guard let panGesture = $0 as? UIPanGestureRecognizer else { return }
            panGesture.delegate = ScrollViewGestureDelegate.shared
        }
    }
}

class ScrollViewGestureDelegate: NSObject, UIGestureRecognizerDelegate {
    static let shared = ScrollViewGestureDelegate()
    
    func gestureRecognizer(_ gestureRecognizer: UIGestureRecognizer, shouldRecognizeSimultaneouslyWith otherGestureRecognizer: UIGestureRecognizer) -> Bool {
        return true
    }
    
    func gestureRecognizer(_ gestureRecognizer: UIGestureRecognizer, shouldBeRequiredToFailBy otherGestureRecognizer: UIGestureRecognizer) -> Bool {
        guard let scrollView = gestureRecognizer.view as? UIScrollView else { return false }
        // 当ScrollView滚动到顶部时，让Sheet的手势优先触发
        return scrollView.contentOffset.y <= -scrollView.contentInset.top
    }
}

方案2：添加顶部触发区域 #

在每个ScrollView顶部添加一个透明的可拖动区域，直接绑定Sheet的关闭逻辑：

struct ContentView: View {
    @State private var sheetPresented = true
    
    var body: some View {
        VStack {}
            .sheet(isPresented: $sheetPresented) {
                TabView {
                    ScrollView(.vertical) {
                        // 顶部透明区域，用于触发下拉关闭
                        Color.clear
                            .frame(height: 1)
                            .simultaneousGesture(DragGesture(minimumDistance: 10)
                                .onChanged { _ in
                                    sheetPresented = false
                                })
                        
                        ForEach(0..<100) { i in
                            Text("Item \(i)")
                                .containerRelativeFrame(.horizontal)
                        }
                    }
                    .tag(0)
                    
                    ScrollView(.vertical) {
                        Color.clear
                            .frame(height: 1)
                            .simultaneousGesture(DragGesture(minimumDistance: 10)
                                .onChanged { _ in
                                    sheetPresented = false
                                })
                        
                        ForEach(0..<100) { i in
                            Text("Item \(i)")
                                .containerRelativeFrame(.horizontal)
                        }
                    }
                    .tag(1)
                }
                .tabViewStyle(.page(indexDisplayMode: .never))
            }
    }
}

方案3：利用SwiftUI内置API（iOS 15+） #

通过设置scrollDismissesKeyboard为.interactively，让系统自动协调手势优先级：

struct ContentView: View {
    @State private var sheetPresented = true
    
    var body: some View {
        VStack {}
            .sheet(isPresented: $sheetPresented) {
                TabView {
                    ScrollView(.vertical) {
                        ForEach(0..<100) { i in
                            Text("Item \(i)")
                                .containerRelativeFrame(.horizontal)
                        }
                    }
                    .tag(0)
                    .scrollDismissesKeyboard(.interactively)
                    
                    ScrollView(.vertical) {
                        ForEach(0..<100) { i in
                            Text("Item \(i)")
                                .containerRelativeFrame(.horizontal)
                        }
                    }
                    .tag(1)
                    .scrollDismissesKeyboard(.interactively)
                }
                .tabViewStyle(.page(indexDisplayMode: .never))
                .interactiveDismissDisabled(false) // 默认即为false，可省略
            }
    }
}

方案说明 #

• 方案1：从手势识别底层解决问题，适配所有复杂场景，效果最稳定；
• 方案2：实现简单，适合快速调试，但需要额外添加触发区域；
• 方案3：代码最简洁，依赖iOS 15+的API，适合新版本系统的项目。

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