Xcode12.3 Swift5下自定义NSWindow标题栏关闭按钮设计的方法
自定义NSWindow关闭按钮样式失效的核心原因
尝试直接修改standardWindowButton(.closeButton)的layer属性无法生效,本质是Cocoa的窗口控制按钮由AppKit私有绘制逻辑完全托管:
- 按钮的图层属性、绘制内容会被系统每帧的渲染流程覆盖,手动写入的layer参数没有持久化生效的空间
- 这类按钮默认未开放自定义图层的绘制权限,即便手动开启
wantsLayer,也无法抵消系统默认的绘制逻辑
可行的落地实现思路
思路1:替换按钮状态图标,保留系统原生交互
不需要改动按钮的视图层级,直接替换按钮在不同交互状态下的显示内容,同时移除系统默认的子视图绘制元素:
guard let closeButton = window?.standardWindowButton(.closeButton) else { return } // 移除系统默认绘制的子视图图层 closeButton.subviews.forEach { $0.removeFromSuperview() } // 绑定自定义的各状态图标 closeButton.image = NSImage(named: "custom-close-normal") closeButton.alternateImage = NSImage(named: "custom-close-active") closeButton.imagePosition = .imageOnly closeButton.isBordered = false
- 这段代码需要在
windowDidLoad、窗口完成首次布局的时机执行,过早执行会因为系统未完成按钮初始化被覆盖
思路2:完全隐藏原生按钮,自绘自定义控件
如果需要实现无限制的样式定制(比如修改圆角、自定义阴影、调整点击热区、添加交互动画),可以直接隐藏系统原生的关闭按钮,在标题栏对应位置添加自定义NSButton:
// 隐藏系统原生关闭按钮 window?.standardWindowButton(.closeButton)?.isHidden = true // 初始化自定义按钮 let closeBtn = NSButton(frame: NSRect(x: 12, y: window!.frame.height - 20, width: 16, height: 16)) closeBtn.bezelStyle = .inline closeBtn.isBordered = false closeBtn.image = NSImage(named: "custom-close-icon") // 绑定关闭响应逻辑 closeBtn.target = self closeBtn.action = #selector(performClose(_:)) window?.contentView?.addSubview(closeBtn)
- 该方式的优势是不会被系统绘制逻辑干扰,所有样式完全可控;需要注意适配不同系统版本的标题栏布局,避免和最小化、缩放按钮的位置重叠
思路3:方法替换拦截系统绘制流程
如果既要保留系统按钮的原生位置、点击交互体验,又要修改视觉样式,可以通过Swift方法替换的方式,拦截目标按钮的draw(_:)流程:
- 在系统原有绘制逻辑执行完成后,通过贝塞尔路径自定义绘制按钮的圆形背景、关闭叉号的颜色和形态
- 需要额外做不同macOS版本的兼容适配,避免私有API变更导致的布局错乱
内容的提问来源于stack exchange,提问作者Lukas
相关产品推荐
相关产品推荐

