MacOS Swift App：如何实现含标题栏的窗口渐变背景

你已成功为窗口内容视图添加渐变背景，但无法将渐变延伸至标题栏区域，以下是修正后的解决方案：

关键修改点 #

• 启用窗口全屏内容布局，让内容视图延伸至标题栏区域
• 将渐变层的范围设置为整个窗口边界，而非仅内容视图
• 确保颜色值转换为CGColor类型（CAGradientLayer仅支持该颜色格式）

修改后的完整代码 #

HomeWindowController.swift #

import Cocoa

class HomeWindowController: NSWindowController {
    // 替换为你实际使用的颜色
    private let color01 = NSColor.systemBlue.cgColor
    private let color02 = NSColor.systemPurple.cgColor

    override func windowDidLoad() {
        super.windowDidLoad()
        
        guard let window = self.window else { return }
        
        // 启用内容视图覆盖标题栏的布局
        window.styleMask.insert(.fullSizeContentView)
        // 移除标题栏方向的内容边框厚度
        window.setContentBorderThickness(0, for: .minY)
        
        // 创建渐变层
        let gradientLayer = CAGradientLayer()
        // 设置渐变层范围为整个窗口
        gradientLayer.frame = window.bounds
        gradientLayer.colors = [color01, color02]
        // 可选：自定义渐变方向，默认从上到下
        // gradientLayer.startPoint = CGPoint(x: 0, y: 0)
        // gradientLayer.endPoint = CGPoint(x: 1, y: 1)
        
        // 为内容视图添加渐变层
        window.contentView?.layer = gradientLayer
        // 确保内容视图支持图层渲染
        window.contentView?.wantsLayer = true
    }
}

AppDelegate.swift（简化版） #

import Cocoa

@main
class AppDelegate: NSObject, NSApplicationDelegate {
    func applicationDidFinishLaunching(_ aNotification: Notification) {
        guard let mainWindow = NSApplication.shared.windows.first else { return }
        // 设置标题栏透明
        mainWindow.titlebarAppearsTransparent = true
        // 设置窗口背景透明，避免遮挡渐变
        mainWindow.backgroundColor = .clear
        // 可选：隐藏窗口标题（若不需要显示）
        // mainWindow.titleVisibility = .hidden
    }
}

额外说明 #

• 若需保留窗口标题，确保titleVisibility设为.visible，透明标题栏会自动适配渐变背景
• 窗口大小改变时，若渐变层未自动适配，可在windowDidResize方法中重新设置gradientLayer.frame = window.bounds

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