SwiftUI macOS：弹窗视图的工具栏项为何显示在主工具栏？

问题根源 #

在macOS的SwiftUI中，默认所有视图层级里的toolbar和searchable修饰符都会向上合并到当前窗口的主工具栏——不管是弹窗（如sheet、popover）还是嵌套视图，都会共享同一窗口的工具栏空间，这就是弹窗控件跑到主工具栏的原因。

解决方案 #

1. 给弹窗/独立视图创建专属窗口 #

这是实现完全独立工具栏最彻底的方式：

• 对于sheet，可以直接在弹窗视图上添加toolbar并配合窗口样式配置，让弹窗拥有自己的工具栏：

.sheet(isPresented: $showPopup) {
    PopupView()
        .toolbar {
            Button(action: { showPopup = false }) {
                Image(systemName: "x.circle")
            }
        }
        .windowStyle(.hiddenTitleBar) // 可根据需求调整窗口样式
}

• 也可以手动通过NSWindow和NSWindowController创建独立窗口，这种方式灵活性更高，完全隔离主窗口的工具栏。

2. 用ToolbarItemGroup限定作用域 #

如果不想新建窗口，可以通过ToolbarItemGroup指定控件的放置位置，减少和主工具栏的冲突：

// 弹窗内的工具栏代码
.toolbar {
    ToolbarItemGroup(placement: .primaryAction) {
        Button(action: { selectedItemId = nil }) {
            Image(systemName: "x.circle")
        }
    }
}

注意：这种方式只是调整控件位置，无法完全隔离，适合不需要彻底独立的场景。

3. 动态切换主工具栏内容 #

通过状态变量标记当前是否显示弹窗，在主视图的工具栏里动态控制内容显示：

// 主视图的工具栏
.toolbar {
    if !showPopup {
        // 主工具栏原有控件
        Button("Main Action") {}
    }
}

// 弹窗视图
.sheet(isPresented: $showPopup) {
    PopupView()
        .toolbar {
            Button(action: { showPopup = false }) {
                Image(systemName: "x.circle")
            }
        }
}

这种方式能避免主工具栏和弹窗工具栏同时显示，但弹窗的工具栏仍会占用主窗口的工具栏空间。

4. 调整searchable的放置位置 #

对于searchable，修改placement参数可以避免它跑到主工具栏：

// 弹窗内的搜索框，指定放置在侧边栏或自动适配
.searchable(text: $searchText, placement: .sidebar) {}

如果结合独立窗口使用，搜索框会自动归属到弹窗的专属工具栏中。

总结 #

• 若需要完全独立的工具栏和搜索框，优先给弹窗类视图创建独立窗口，这是macOS下隔离视图工具栏最可靠的方式。
• 临时调整的话，动态切换主工具栏内容或限定工具栏组位置可以作为折中方案。

内容的提问来源于stack exchange，提问作者alex.bour