macOS 14 SwiftUI中NavigationSplitView透明背景设置求助

核心解决步骤 #

针对侧边栏和工具栏的背景透明需求，需通过Swift Introspection定位对应AppKit原生控件，直接修改其背景属性：

1. 侧边栏背景透明 #

通过Introspection获取NSSplitView，定位侧边栏容器视图并递归清除其及子视图的背景色：

NavigationSplitView {
    SidebarView()
        .introspect(.navigationSplitView(style: .automatic), on: .macOS(.v14)) { splitView in
            // 筛选侧边栏容器（宽度小于SplitView一半的子视图）
            guard let sidebarContainer = splitView.subviews.first(where: { $0.frame.width < splitView.frame.width / 2 }) else { return }
            
            // 递归清除所有子视图背景
            func clearBackground(for view: NSView) {
                view.backgroundColor = .clear
                view.subviews.forEach(clearBackground)
            }
            clearBackground(for: sidebarContainer)
        }
} content: {
    ContentView()
        .background(.clear)
} detail: {
    DetailView()
        .background(.clear)
}

2. 工具栏背景透明 #

通过Introspection获取窗口实例，修改工具栏的背景绘制属性：

NavigationSplitView {
    // 侧边栏代码
} content: {
    // 内容视图代码
} detail: {
    // 详情视图代码
}
.introspect(.window, on: .macOS(.v14)) { window in
    window.toolbar?.drawsBackground = false
    window.toolbar?.backgroundStyle = .unified
    // 若需复刻Home应用的模糊背景，可添加以下设置
    window.backgroundColor = .clear
    window.isOpaque = false
    window.styleMask.insert(.fullSizeContentView)
}

额外提示 #

• 确保Swift Introspection库版本适配macOS 14，避免API兼容问题
• 若需要Home应用的半透明模糊效果，可在根视图添加background(.ultraThinMaterial)替代纯透明设置
• 测试时需覆盖全屏、窗口化等不同状态，确保效果一致

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