SwiftUI macOS 点击手势阻塞工具栏双击调整窗口大小问题

开启HiddenTitleBarWindowStyle()后，SwiftUI会让根内容视图铺满整个窗口，包含顶部工具栏所在的原标题栏区域。直接绑定在根视图上的.onTapGesture默认优先级高于窗口层的系统手势识别，会消费所有命中的鼠标事件，导致双击工具栏的缩放事件无法传递到系统处理逻辑，功能失效。

方案一：限定点击手势响应范围（最稳定，推荐） #

将点击手势的响应范围限定在工具栏以下的内容区域，不对工具栏区域的事件做拦截，即可保留系统原生双击缩放能力。
你可以通过窗口的contentLayoutRect直接拿到不包含工具栏的内容区域，判断点击位置落在内容区时才响应tap逻辑，修改后的完整代码：

import SwiftUI

struct TapGesturesMacOSApp: App {
    var body: some Scene {
        WindowGroup {
            ContentView()
                .frame(minWidth: 400, maxWidth: .infinity, minHeight: 300, maxHeight: .infinity)
        }
        .windowStyle(HiddenTitleBarWindowStyle())
        .windowToolbarStyle(UnifiedWindowToolbarStyle())
    }
}

struct ContentView: View {
    var body: some View {
        Rectangle()
            .frame(maxWidth: .infinity, maxHeight: .infinity)
            .background(.gray)
            .onTapGesture(coordinateSpace: .global) { location in
                // 过滤工具栏区域的点击，不消费该区域事件
                guard let window = NSApp.keyWindow else { return }
                // 窗口内容区（不含工具栏）的顶部Y坐标
                let contentTopY = window.frame.height - window.contentLayoutRect.height - window.contentLayoutRect.origin.y
                // 点击位置Y坐标小于contentTopY说明在内容区，响应tap；否则不处理，让事件传给系统
                guard location.y < contentTopY else { return }
                print("Background tapped")
            }
            .toolbar {
                Button("Button") { }
            }
    }
}

注意：带coordinateSpace参数的onTapGesture支持macOS 13+，低版本可通过GeometryReader做坐标转换实现相同逻辑。

方案二：使用非阻断式手势 #

如果你不想手动判断点击区域，可以用simultaneousGesture修饰符，让自定义手势和系统手势同时识别，不抢占事件的响应权：

import SwiftUI

struct TapGesturesMacOSApp: App {
    var body: some Scene {
        WindowGroup {
            ContentView()
                .frame(minWidth: 400, maxWidth: .infinity, minHeight: 300, maxHeight: .infinity)
                // 替换原有的onTapGesture
                .simultaneousGesture(
                    TapGesture()
                        .onEnded {
                            print("Background tapped")
                        }
                )
        }
        .windowStyle(HiddenTitleBarWindowStyle())
        .windowToolbarStyle(UnifiedWindowToolbarStyle())
    }
}

struct ContentView: View {
    var body: some View {
        Rectangle()
            .frame(maxWidth: .infinity, maxHeight: .infinity)
            .background(.gray)
            .toolbar {
                Button("Button") { }
            }
    }
}

这个方案代码更简洁，但部分macOS版本下可能出现手势冲突的偶现问题，优先推荐方案一。

• 不要将点击手势绑定在包含toolbar的最外层根视图上，尽量绑定到实际的内容背景元素上，从根源上减少手势覆盖的无效区域。
• 如果你的工具栏是透明样式（和内容背景打通），方案一的区域判断逻辑是最可靠的，不会影响任何系统原生窗口交互。

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