状态栏项中NSPopover搭配NavigationStack的返回按钮缺失问题

问题描述 #

在状态栏项触发的NSPopover内使用NavigationStack实现页面导航，跳转至新视图后左上角没有返回按钮，无法回到原导航栈。

相关代码 #

AppDelegate代码 #

import SwiftUI

@main
class AppDelegate: NSObject, NSApplicationDelegate {
    var popover: NSPopover!
    
    let statusItem = NSStatusBar.system.statusItem(withLength: 125)
    
    @IBOutlet weak var menu: NSMenu!
        override internal func awakeFromNib() {
            statusItem.button?.action = #selector(togglePopover(_:))
    }
    
    func applicationDidFinishLaunching(_ aNotification: Notification) {
        let popover = NSPopover()
        self.popover = popover
        
        popover.contentViewController = NSHostingController(rootView: NavigatorView() )
    }
    
    @objc func togglePopover(_ sender: AnyObject?) {
         if let button = statusItem.button {
              if self.popover.isShown {
                   self.popover.performClose(sender) } else {
                       self.popover.behavior = NSPopover.Behavior.transient
                       self.popover.show(relativeTo: button.bounds, of: button, preferredEdge: NSRectEdge.minY)
                        
    } } } }

NavigatorView代码 #

import SwiftUI

struct NavigatorView: View {
    var body: some View {
        NavigationStack {
            List {
                NavigationLink("Test", destination: EmptyView())
            }
        }
    }
}

解决方案 #

问题根源在于macOS下SwiftUI的NavigationStack默认不会自动渲染导航栏，必须通过设置导航标题激活导航栏，同时EmptyView无内容也会影响导航栏显示逻辑。具体修改如下：

1. 修改NavigatorView，添加导航标题并替换EmptyView为实际视图 #

import SwiftUI

struct NavigatorView: View {
    var body: some View {
        NavigationStack {
            List {
                NavigationLink("Test", destination: TestView())
            }
            .navigationTitle("主页面") // 添加导航标题，触发导航栏渲染
        }
    }
}

// 替换EmptyView为带内容的目标视图
struct TestView: View {
    var body: some View {
        Text("测试页面")
            .navigationTitle("测试") // 目标视图也设置导航标题
    }
}

2. 可选：设置Popover内容尺寸（确保导航栏有足够显示空间） #

在applicationDidFinishLaunching方法中添加Popover尺寸设置：

func applicationDidFinishLaunching(_ aNotification: Notification) {
    let popover = NSPopover()
    self.popover = popover
    
    popover.contentViewController = NSHostingController(rootView: NavigatorView() )
    popover.contentSize = NSSize(width: 300, height: 400) // 设置合适的内容尺寸
}

原理说明 #

macOS的SwiftUI NavigationStack依赖navigationTitle来激活导航栏组件，没有标题时导航栏会被隐藏，导致返回按钮无法显示。同时EmptyView因无布局内容，也会让导航栏的渲染逻辑失效，替换为有实际内容的视图可以确保导航栏正常工作。

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