macOS High Sierra下NSWindowController工具栏混合模式异常问题

问题现象 #

在macOS Catalina中，工具栏的混合模式运行流畅无异常；但在macOS High Sierra中存在以下问题：

• 从下往上滚动视图内容填充工具栏时，颜色可随内容正常变化
• 从上往下滚动至工具栏区域无内容覆盖时，工具栏会保留最后一次或视图顶部内容的颜色（例如TableView选中首行后滚动，再次向下滚动时工具栏始终显示蓝色；选中非首行滚动时，工具栏会被清除为蓝色）

原因分析 #

macOS Catalina（10.15）对NSToolbar的滚动背景融合逻辑做了底层优化，修复了旧版本中背景状态缓存不及时的问题。而High Sierra（10.13）的NSToolbar实现中，当滚动内容离开工具栏区域时，没有正确触发背景重置逻辑，导致残留之前的内容颜色或选中状态颜色。

解决方案 #

1. 监听滚动视图事件，手动更新工具栏状态 #

给TableView所在的NSScrollView添加代理，在滚动时判断位置，当内容顶部超出工具栏区域时强制重置工具栏背景：

// 在包含TableView的ViewController中添加
extension YourTableViewController: NSScrollViewDelegate {
    func scrollViewDidScroll(_ scrollView: NSScrollView) {
        let contentOffsetY = scrollView.documentView?.frame.origin.y ?? 0
        let toolbarHeight = NSApp.mainWindow?.toolbar?.frame.height ?? 0
        
        // 当内容顶部高于工具栏底部时，触发工具栏重绘
        if contentOffsetY >= toolbarHeight {
            NSApp.mainWindow?.toolbar?.setNeedsDisplay()
            // 若有自定义默认背景色，可手动设置：
            // NSApp.mainWindow?.toolbar?.backgroundColor = .windowBackgroundColor
        }
    }
}

2. 监听TableView选中状态变化，同步更新工具栏 #

当TableView选中状态改变时，立即触发工具栏重绘，避免选中颜色残留：

extension YourTableViewController: NSTableViewDelegate {
    func tableViewSelectionDidChange(_ notification: Notification) {
        NSApp.mainWindow?.toolbar?.setNeedsDisplay()
    }
}

3. 优化WindowController中的工具栏配置 #

在windowDidLoad中补充工具栏的兼容性配置：

override func windowDidLoad() {
    super.windowDidLoad()
    self.window?.delegate = self
    
    // 配置工具栏基础样式，确保混合模式在旧系统正常工作
    self.window?.toolbar?.isVisible = true
    self.window?.toolbar?.displayMode = .iconOnly // 根据需求调整
    self.window?.toolbar?.sizeMode = .regular
    
    // ... 原有窗口大小保存、事件监听等代码 ...
    
    if let splitViewController = self.contentViewController as? SplitVC {
        delegate = splitViewController
        // 给TableView的滚动视图绑定代理
        if let tableVC = splitViewController.children.compactMap({ $0 as? YourTableViewController }).first {
            tableVC.tableView.enclosingScrollView?.delegate = tableVC
        }
    }
}

注意事项 #

• 需针对High Sierra系统单独测试，确保滚动和选中操作后工具栏状态正确
• 若使用自定义工具栏背景，重置时需设置对应默认颜色，避免视觉突兀

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