macOS Sequoia下NSScrollView滚动条无法自动隐藏的解决方法

问题描述 #

在macOS Sequoia系统中，即使将NSScrollView的autohidesScrollers属性设置为true，滚动条仍持续可见。在macOS Sonoma及更低版本中，滚动条叠加在内容上方且能正常自动隐藏；但Sequoia里滚动条会占用内容空间，搭配NSStackView时会导致内容随滚动条显隐调整尺寸，仅在窗口或滚动视图大小改变时才会隐藏。

问题复现代码 #

class ViewController: NSViewController {
    
    override func viewDidLoad() {
        super.viewDidLoad()
        
        let scrollView = NSScrollView()
        scrollView.translatesAutoresizingMaskIntoConstraints = false
        scrollView.borderType = .bezelBorder
        scrollView.hasVerticalScroller = true
        scrollView.hasHorizontalScroller = true
        scrollView.autohidesScrollers = true
        scrollView.drawsBackground = false
        
        // 创建内容视图
        let contentView = NSView(frame: NSRect(x: 0, y: 0, width: 400, height: 400))
        contentView.wantsLayer = true
        contentView.layer?.backgroundColor = NSColor.blue.cgColor
        
        // 绑定内容视图到滚动视图
        scrollView.documentView = contentView
        
        // 将滚动视图添加到主视图
        self.view.addSubview(scrollView)
        
        // 设置自动布局约束
        NSLayoutConstraint.activate([
            scrollView.leadingAnchor.constraint(equalTo: self.view.leadingAnchor, constant: 20),
            scrollView.trailingAnchor.constraint(equalTo: self.view.trailingAnchor, constant: -20),
            scrollView.topAnchor.constraint(equalTo: self.view.topAnchor, constant: 20),
            scrollView.bottomAnchor.constraint(equalTo: self.view.bottomAnchor, constant: -20)
        ])
    }
}

问题现象截图 #

可行解决方案 #

1. 强制设置滚动条为叠加模式 #

macOS Sequoia默认采用内容内嵌式滚动条，会占用内容空间。通过将滚动条样式设置为.overlay，可恢复旧系统中滚动条叠加在内容上方的行为，同时正常触发自动隐藏：

scrollView.scrollerStyle = .overlay

将此代码添加到滚动视图初始化逻辑中即可生效。

2. 手动监听滚动事件控制显隐 #

若需要更灵活的显隐时机控制，可监听滚动视图的边界变化事件，手动调整滚动条的透明度：

override func viewDidLoad() {
    super.viewDidLoad()
    // ... 原有滚动视图初始化代码 ...
    
    // 开启边界变化通知
    scrollView.contentView.postsBoundsChangedNotifications = true
    NotificationCenter.default.addObserver(
        forName: NSView.boundsDidChangeNotification,
        object: scrollView.contentView,
        queue: .main
    ) { [weak self] _ in
        guard let scrollView = self?.view.subviews.first as? NSScrollView else { return }
        // 滚动时显示滚动条
        scrollView.verticalScroller?.alphaValue = 1.0
        scrollView.horizontalScroller?.alphaValue = 1.0
        
        // 滚动停止后延迟隐藏
        DispatchQueue.main.asyncAfter(deadline: .now() + 1.5) {
            scrollView.verticalScroller?.alphaValue = 0.0
            scrollView.horizontalScroller?.alphaValue = 0.0
        }
    }
}

注意保持autohidesScrollers为true，可根据需求调整延迟隐藏的时间。

3. 自定义滚动条子类实现自动隐藏逻辑 #

通过自定义NSScroller子类，重写滚动事件处理来控制显隐：

class AutoHideScroller: NSScroller {
    override func viewDidMoveToWindow() {
        super.viewDidMoveToWindow()
        // 初始状态隐藏
        alphaValue = 0.0
    }
    
    override func scrollWheel(with event: NSEvent) {
        super.scrollWheel(with: event)
        // 滚动时显示
        alphaValue = 1.0
        // 滚动停止后延迟隐藏
        DispatchQueue.main.asyncAfter(deadline: .now() + 1.5) {
            self.alphaValue = 0.0
        }
    }
}

然后在初始化滚动视图时替换默认滚动条：

scrollView.verticalScroller = AutoHideScroller()
scrollView.horizontalScroller = AutoHideScroller()

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