如何在SwiftUI中实现macOS全屏宽度的工具栏（标题栏附件）

问题背景 #

基于NavigationSplitView开发时，自带的侧边栏切换按钮在显示/隐藏、全屏/窗口状态下的位置和动画均正常，需要实现一个从该切换按钮右侧延伸至窗口右边缘的全屏宽度工具栏。尝试以下方法遇到问题：

• .toolbar modifier无效：将自定义红色占位工具栏放在ToolbarItem(placement: .principal)中时，工具栏仅显示10×10pt，推测是ToolbarItem无法传递父视图尺寸给子视图。
• NSTitlebarAccessoryViewController触发布局异常：结合NSHostingView和NSTitlebarAccessoryViewController时，出现运行时断言错误：changing the view's origin is not allowed，核心报错来自NSTitlebarAccessoryViewController.m:341。
• GeometryReader导致动画卡顿：尝试用GeometryReader设置工具栏尺寸时，侧边栏切换、全屏切换、窗口调整等动画出现明显卡顿。

可行方案及修复步骤 #

使用NSTitlebarAccessoryViewController的思路是可行的，之前的错误源于直接修改accessory view的origin，违反了AppKit对NSTitlebarAccessoryViewController的布局管理规则。正确的做法是让系统管理accessory view的整体位置，在SwiftUI视图内部调整内容的偏移。

1. 修正AppDelegate中的Accessory配置 #

class AppDelegate: NSObject, NSApplicationDelegate {
    func applicationDidFinishLaunching(_ notification: Notification) {
        guard let window = NSApplication.shared.windows.first else { return }
        window.titlebarAppearsTransparent = true
        window.titleVisibility = .hidden
        window.toolbar?.showsBaselineSeparator = false
        
        // 创建SwiftUI工具栏视图
        let toolbarView = Toolbar()
        let hostingView = NSHostingView(rootView: toolbarView)
        
        // 配置titlebar accessory控制器
        let accessoryVC = NSTitlebarAccessoryViewController()
        accessoryVC.view = hostingView
        accessoryVC.layoutAttribute = .leading // 让accessory从titlebar左侧开始布局
        accessoryVC.layoutPriority = .defaultHigh
        
        window.addTitlebarAccessoryViewController(accessoryVC)
        
        // 约束accessory视图填充整个titlebar区域
        NSLayoutConstraint.activate([
            hostingView.widthAnchor.constraint(equalTo: window.titlebarLayoutGuide.widthAnchor),
            hostingView.heightAnchor.constraint(equalTo: window.titlebarLayoutGuide.heightAnchor)
        ])
    }
}

2. 调整SwiftUI Toolbar视图的内容偏移 #

通过获取侧边栏切换按钮的宽度，给红色工具栏添加leading padding，让内容从切换按钮右侧开始延伸：

struct Toolbar: View {
    @State private var toggleButtonOffset: CGFloat = 0
    
    var body: some View {
        Color.red
            .padding(.leading, toggleButtonOffset)
            .onAppear {
                // 获取侧边栏切换按钮的宽度
                guard let window = NSApplication.shared.windows.first,
                      let toolbar = window.toolbar,
                      let toggleItem = toolbar.items.first(where: { $0.itemIdentifier == .sidebarTrackingSeparator }) else {
                    return
                }
                toggleButtonOffset = toggleItem.view?.frame.width ?? 0
            }
            .onReceive(NotificationCenter.default.publisher(for: NSWindow.didResizeNotification)) { _ in
                // 窗口尺寸变化时重新获取按钮宽度（适配窗口状态变化）
                guard let window = NSApplication.shared.windows.first,
                      let toolbar = window.toolbar,
                      let toggleItem = toolbar.items.first(where: { $0.itemIdentifier == .sidebarTrackingSeparator }) else {
                    return
                }
                toggleButtonOffset = toggleItem.view?.frame.width ?? 0
            }
    }
}

3. 原ContentView保持不变 #

struct ContentView: View {
    @NSApplicationDelegateAdaptor(AppDelegate.self) var appDelegate

    var body: some View {
        NavigationSplitView {
            Text("Sidebar")
        } detail: {
            Text("Detail")
        }
    }
}

关键说明 #

• 避免直接修改NSTitlebarAccessoryViewController管理的view的origin约束：AppKit对titlebar accessory的布局有内部规则，手动修改leading/origin会触发断言错误，应让系统管理accessory的整体位置，在SwiftUI内部调整内容偏移。
• 减少不必要的重绘：通过onAppear和窗口resize通知获取切换按钮宽度，而非用GeometryReader实时监听，避免频繁重绘导致的动画卡顿。

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