macOS下非关键窗口的WKWebView如何接收鼠标移动事件？

你的核心问题出在全局事件的坐标未转换——NSEvent.addGlobalMonitorForEvents拿到的事件坐标是屏幕坐标系，而WKWebView需要的是自身视图内的本地坐标，直接转发的话，鼠标位置不在网页的有效范围内，自然触发不了悬停效果。

以下是可行的修复方案：

1. 坐标转换与事件重造 #

在转发鼠标事件前，必须将屏幕坐标转换为WKWebView的本地坐标，并基于新坐标创建一个符合要求的NSEvent实例，再传递给WebView。

修改你的setEventHandler方法中鼠标相关事件的处理逻辑：

func setEventHandler() {
    self.eventHandler = NSEvent.addGlobalMonitorForEvents(matching: .any) { [weak self] event in
        guard let self = self,
              let webview = self.wallpaperWindow.contentView?.subviews.first?.subviews.first as? WKWebView,
              let frontmostApp = NSWorkspace.shared.frontmostApplication,
              frontmostApp.bundleIdentifier == "com.apple.finder" else {
            return
        }
        
        // 通用坐标转换方法：屏幕坐标 → WebView本地坐标
        func convertToWebViewLocalPoint(_ screenPoint: NSPoint) -> NSPoint {
            let pointInWindow = self.wallpaperWindow.convert(fromScreen: screenPoint)
            return webview.convert(pointInWindow, from: nil)
        }
        
        switch event.type {
        case .scrollWheel:
            webview.scrollWheel(with: event)
            
        case .mouseMoved:
            let localPoint = convertToWebViewLocalPoint(event.location)
            guard let modifiedEvent = NSEvent.mouseEvent(
                with: .mouseMoved,
                location: localPoint,
                modifierFlags: event.modifierFlags,
                timestamp: event.timestamp,
                windowNumber: webview.window?.windowNumber ?? 0,
                context: event.context,
                eventNumber: event.eventNumber,
                clickCount: event.clickCount,
                pressure: event.pressure
            ) else { break }
            webview.mouseMoved(with: modifiedEvent)
            
        case .mouseEntered, .mouseExited:
            let localPoint = convertToWebViewLocalPoint(event.location)
            guard let modifiedEvent = NSEvent.mouseEvent(
                with: event.type,
                location: localPoint,
                modifierFlags: event.modifierFlags,
                timestamp: event.timestamp,
                windowNumber: webview.window?.windowNumber ?? 0,
                context: event.context,
                eventNumber: event.eventNumber,
                clickCount: event.clickCount,
                pressure: event.pressure
            ) else { break }
            event.type == .mouseEntered ? webview.mouseEntered(with: modifiedEvent) : webview.mouseExited(with: modifiedEvent)
            
        case .leftMouseUp, .rightMouseUp:
            let localPoint = convertToWebViewLocalPoint(event.location)
            guard let modifiedEvent = NSEvent.mouseEvent(
                with: event.type,
                location: localPoint,
                modifierFlags: event.modifierFlags,
                timestamp: event.timestamp,
                windowNumber: webview.window?.windowNumber ?? 0,
                context: event.context,
                eventNumber: event.eventNumber,
                clickCount: event.clickCount,
                pressure: event.pressure
            ) else { break }
            webview.mouseUp(with: modifiedEvent)
            
        case .leftMouseDown:
            let localPoint = convertToWebViewLocalPoint(event.location)
            guard let modifiedEvent = NSEvent.mouseEvent(
                with: .leftMouseDown,
                location: localPoint,
                modifierFlags: event.modifierFlags,
                timestamp: event.timestamp,
                windowNumber: webview.window?.windowNumber ?? 0,
                context: event.context,
                eventNumber: event.eventNumber,
                clickCount: event.clickCount,
                pressure: event.pressure
            ) else { break }
            webview.mouseDown(with: modifiedEvent)
            
        case .leftMouseDragged, .rightMouseDragged:
            let localPoint = convertToWebViewLocalPoint(event.location)
            guard let modifiedEvent = NSEvent.mouseEvent(
                with: event.type,
                location: localPoint,
                modifierFlags: event.modifierFlags,
                timestamp: event.timestamp,
                windowNumber: webview.window?.windowNumber ?? 0,
                context: event.context,
                eventNumber: event.eventNumber,
                clickCount: event.clickCount,
                pressure: event.pressure
            ) else { break }
            webview.mouseDragged(with: modifiedEvent)
            
        default:
            break
        }
    }
}

2. 确保WKWebView启用鼠标移动事件 #

在初始化WKWebView时，显式开启鼠标移动事件接收：

let webViewConfig = WKWebViewConfiguration()
// 其他配置项...
let webview = WKWebView(frame: .zero, configuration: webViewConfig)
webview.acceptsMouseMovedEvents = true

原理说明 #

全局事件监听拿到的事件是基于整个屏幕的，而WKWebView的事件处理依赖自身视图坐标系的位置。如果坐标不转换，WebView会认为鼠标不在自己的范围内，不会触发网页的hover等交互逻辑。通过重新创建带本地坐标的事件，就能让WebView正确识别鼠标位置，进而传递给网页。

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