SwiftUI添加onTapGesture收键盘后NavigationLink等交互失效如何解决？

问题根因 #

你给外层ZStack添加的全局点击手势默认会优先拦截所有点击事件，导致List内的NavigationLink、TextField等交互组件的点击事件没有被正常响应。

可行解决方案 #

方案1：手势加在背景层（最简单，改动最小） #

不要把tap手势加在整个ZStack上，改为加在底层的全屏Color上，只有点击List外的空白区域才会触发收起键盘，完全不影响List内部交互：

ZStack(alignment: .leading, content: {
    Color.pacificBlue
        .edgesIgnoringSafeArea(.all)
        // 手势加在这里，仅点击背景空白区域生效
        .onTapGesture {
            self.dismissKeyboard()
        }
    List {
        Section(header: Text("Header")) {
            NavigationLink(
                destination: SecondaryView(),
                label: {
                    Text("Secondary View")
                })
            TextField("MyField", text: self.$myField)
        }
     }
})

方案2：配置手势响应优先级，子视图优先 #

如果需要点击List内的非交互区域也能收起键盘，可以调整外层手势的响应规则，优先响应子视图的交互事件，子视图未处理的点击才会触发收起键盘：
将原来的onTapGesture替换为以下写法：

.gesture(
    TapGesture()
        .onEnded { _ in
            dismissKeyboard()
        }
, including: .subviews
)

方案3：全局兼容方案（适配所有页面，无需单独配置） #

如果希望所有页面都默认支持点击空白处收起键盘，且完全不影响视图交互，可以通过UIKit扩展给全局Window添加手势：

// 全局添加收起键盘手势
extension UIApplication {
    func addGlobalDismissKeyboardGesture() {
        guard let window = windows.first else { return }
        let tapGesture = UITapGestureRecognizer(target: window, action: #selector(UIView.endEditing))
        tapGesture.cancelsTouchesInView = false
        tapGesture.delegate = self
        window.addGestureRecognizer(tapGesture)
    }
}

extension UIApplication: UIGestureRecognizerDelegate {
    public func gestureRecognizer(_ gestureRecognizer: UIGestureRecognizer, shouldReceive touch: UITouch) -> Bool {
        // 点击交互类组件时不触发收起键盘手势
        return !(touch.view is UIControl)
    }
}

在App入口处调用一次即可全局生效：

@main
struct YourApp: App {
    init() {
        UIApplication.shared.addGlobalDismissKeyboardGesture()
    }
    
    var body: some Scene {
        WindowGroup {
            NavigationStack { // 你的根视图
                ContentView()
            }
        }
    }
}

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