如何在NSPopover中启用.searchable()搜索功能？

我将ContentView作为菜单栏中的NSPopover弹窗展示，实现代码如下：

func applicationDidFinishLaunching(_ aNotification: Notification) {
    // Create the SwiftUI view that provides the window contents.
    let contentView = ContentView()

    // Create the popover
    let popover = NSPopover()
    popover.contentSize = NSSize(width: 500, height: 700)
    popover.behavior = .transient
    popover.contentViewController = NSHostingController(rootView: contentView)
    self.popover = popover
    
    // Create the status item
    self.statusBarItem = NSStatusBar.system.statusItem(withLength: CGFloat(NSStatusItem.variableLength))
    
    if let button = self.statusBarItem.button {
        button.image = NSImage(named:NSImage.Name("Icon"))
        button.action = #selector(togglePopover(_:))
    }
    (NSApp.delegate as! AppDelegate).statusBarItem.button?.image = NSImage(named:NSImage.Name("Icon"))

    NSApp.activate(ignoringOtherApps: true)
}

@objc func togglePopover(_ sender: AnyObject?) {
    if let button = self.statusBarItem.button {
        if self.popover.isShown {
            self.popover.performClose(sender)
        } else {
            self.popover.show(relativeTo: button.bounds, of: button, preferredEdge: NSRectEdge.minY)
        }
        self.popover.contentViewController?.view.window?.becomeKey()
    }
    
    self.popover.contentViewController?.view.window?.becomeKey()
}

我的ContentView添加了.searchable()修饰符，在普通窗口加载时能正常显示搜索栏，但在NSPopover中却无法显示，请问如何适配让搜索功能在NSPopover中生效？

核心原因 #

SwiftUI的.searchable()依赖于NSWindow的搜索栏集成能力，而NSPopover的默认窗口通常未获得足够焦点权限，也未启用搜索相关配置，导致搜索栏无法渲染。

具体修复步骤 #

• 确保Popover窗口获得完整焦点
  修改togglePopover方法，在显示Popover时先激活应用，再将Popover窗口设置为主窗口，而非仅设置为key window：

  @objc func togglePopover(_ sender: AnyObject?) {
      if let button = self.statusBarItem.button {
          if self.popover.isShown {
              self.popover.performClose(sender)
          } else {
              NSApp.activate(ignoringOtherApps: true)
              self.popover.show(relativeTo: button.bounds, of: button, preferredEdge: NSRectEdge.minY)
              // 确保窗口成为主窗口和key窗口
              if let popoverWindow = self.popover.contentViewController?.view.window {
                  popoverWindow.makeKeyAndOrderFront(sender)
              }
          }
      }
  }
  

• 调整Popover的行为配置
  将Popover的behavior从.transient改为.applicationDefined，避免系统自动剥夺窗口焦点：

  popover.behavior = .applicationDefined
  

• 为HostingController添加搜索支持
  创建自定义NSHostingController子类，确保窗口启用搜索栏功能：

  class SearchEnabledHostingController<Content: View>: NSHostingController<Content> {
      override func viewDidAppear() {
          super.viewDidAppear()
          // 配置窗口以支持搜索栏渲染
          view.window?.titleVisibility = .hidden
          view.window?.titlebarAppearsTransparent = true
      }
  }
  

  替换原有的NSHostingController初始化代码：

  popover.contentViewController = SearchEnabledHostingController(rootView: contentView)
  

验证效果 #

完成上述修改后，打开Popover时，SwiftUI的.searchable()修饰符应该能正常渲染搜索栏，且搜索功能可正常使用。

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