macOS开发：如何显示NSPopover时不抢占原第一响应者焦点

核心问题原因 #

NSPopover默认弹出时会将其依附的窗口设为key window，自动抢占第一响应者，打断用户在原输入框的输入流程。之前使用全局事件监听的方案存在缺陷：全局监听无法拦截事件传递，导航用的上下箭头、回车事件会同步下发到原输入区域，导致光标移位、干扰正常输入。 #

具体实现步骤 #

1. 自定义非激活式承载窗口 #

首先重写NSPanel子类，禁止窗口成为key/main响应者，从根源上避免抢焦点：

class NonActivatingPanel: NSPanel {
    override var canBecomeKey: Bool { false }
    override var canBecomeMain: Bool { false }
    
    override init(contentRect: NSRect, styleMask style: NSWindow.StyleMask, backing backingStoreType: NSWindow.BackingStoreType, defer flag: Bool) {
        super.init(contentRect: contentRect, styleMask: style, backing: backingStoreType, defer: flag)
        self.isOpaque = false
        self.backgroundColor = .clear
        // 设置窗口层级为悬浮层，保证显示在其他应用上方
        self.level = .floating
    }
}

2. 修正弹窗展示逻辑 #

替换原有普通NSWindow为自定义的非激活面板，去掉会强制抢焦点的makeKeyAndOrderFront调用，改用不激活应用的orderFrontRegardless方法展示窗口；调整popover的behavior模式避免自动抢焦点。

3. 本地事件拦截替代全局监听 #

使用NSEvent的本地事件监控，仅拦截popover范围内的导航按键，处理完列表导航/选择逻辑后直接吞掉事件（返回nil），不让事件传递到下层原输入框；普通字符输入事件正常放行，不影响用户连续打字。 #

修正后的完整代码 #

func showWidget(at origin: CGPoint, height: CGFloat) {
    let popUpView = NSView()
    // 使用自定义非激活面板承载popover锚点视图
    let window = NonActivatingPanel(
        contentRect: NSRect(origin: origin, size: .init(width: 1, height: 1)),
        styleMask: [.borderless],
        backing: .buffered,
        defer: false
    )
    window.contentView?.addSubview(popUpView)
    popUpView.alignEdges()
    // 仅展示窗口，不设为key窗口、不激活当前应用
    window.orderFrontRegardless()

    popover.contentViewController = widgetController
    popover.behavior = .transient
    popover.contentSize = .init(width: .inputWidgetSize.width, height: 200)
    popover.animates = false
    popover.appearance = NSAppearance(named: .darkAqua)
    popover.show(
        relativeTo: NSRect(origin: .zero, size: .init(width: .inputWidgetSize.width, height: height)),
        of: popUpView,
        preferredEdge: .maxY
    )

    // 注册本地事件监听，拦截导航按键
    NSEvent.addLocalMonitorForEvents(matching: .keyDown) { [weak self] event in
        guard let self = self, self.popover.isShown else { return event }
        // 校验事件发生在popover视图范围内
        let locationInPopover = self.widgetController.view.convert(event.locationInWindow, from: nil)
        guard self.widgetController.view.bounds.contains(locationInPopover) else { return event }

        switch event.keyCode {
        case 126: // 上箭头：选中上一项
            self.widgetController.selectPreviousRow()
            return nil
        case 125: // 下箭头：选中下一项
            self.widgetController.selectNextRow()
            return nil
        case 36: // 回车：插入选中内容、关闭弹窗
            self.widgetController.insertSelectedContent()
            self.popover.performClose(nil)
            return nil
        case 53: // ESC：关闭弹窗
            self.popover.performClose(nil)
            return nil
        default: // 普通字符输入：放行到原输入框
            return event
        }
    }
}

注意事项 #

• 不要使用.semitransient模式的popover，该模式在部分macOS版本会强制触发焦点抢占
• 本地事件监控记得在popover关闭时移除，避免内存泄漏
• 列表选中逻辑selectPreviousRow/selectNextRow需要自行实现，核心是操作NSTableView的selectedRow属性，配合scrollRowToVisible保证选中项可见

内容的提问来源于stack exchange，提问作者Arul Murugan Sivapoosam