NSViewRepresentable托管NSScrollView的Binding绑定失效问题求助

核心错误点 #

• 通知监听对象错误：NSScrollView.boundsDidChangeNotification的发送主体是NSScrollView的contentView（NSClipView类型），而非documentView，同时需要手动开启contentView的postsBoundsChangedNotifications开关才会收到通知。
• 绑定实例过期：你将Binding<CGFloat>存储在TheScrollView的实例属性中，但MyScrollView作为SwiftUI结构体可能被多次重建，传入的Binding实例会更新，但TheScrollView中存储的始终是初始化时的旧实例，对旧实例赋值无法同步到最新的@State变量。
• 缺失双向同步逻辑：未实现updateNSView方法，外部@State变量变更时无法主动同步到ScrollView的滚动位置。

修复后完整代码 #

自定义ScrollView部分 #

import SwiftUI
import Combine

struct MyScrollView<Content>: NSViewRepresentable where Content: View {
    private var content: Content
    @Binding var offset: CGFloat
    
    init(offset: Binding<CGFloat>, @ViewBuilder content: () -> Content) {
        self._offset = offset
        self.content = content()
    }

    func makeNSView(context: Context) -> TheScrollView {
        let view = TheScrollView()
        view.hasVerticalScroller = true
        view.hasHorizontalScroller = true
        // 开启ClipView的bounds变更通知
        view.contentView.postsBoundsChangedNotifications = true
    
        let document = NSHostingView(rootView: content)
        document.translatesAutoresizingMaskIntoConstraints = false
        view.documentView = document
        
        // 监听滚动偏移，同步到Binding
        context.coordinator.cancellable = NotificationCenter.default
            .publisher(for: NSView.boundsDidChangeNotification, object: view.contentView)
            .sink { [weak view] _ in
                guard let view = view else { return }
                let yOffset = view.contentView.bounds.origin.y
                DispatchQueue.main.async {
                    self.offset = yOffset
                }
            }
        
        return view
    }
    
    func updateNSView(_ view: TheScrollView, context: Context) {
        // 外部offset变更时，同步到ScrollView
        let currentY = view.contentView.bounds.origin.y
        if abs(currentY - offset) > 1 { // 加阈值避免循环触发
            view.contentView.setBoundsOrigin(NSPoint(x: view.contentView.bounds.origin.x, y: offset))
            view.reflectScrolledClipView(view.contentView)
        }
    }
    
    func makeCoordinator() -> Coordinator {
        Coordinator()
    }
    
    class Coordinator: NSObject {
        var cancellable: AnyCancellable?
    }
}

class TheScrollView: NSScrollView {
    // 不需要在这里存储Binding，移除相关逻辑
    init() {
        super.init(frame: .zero)
    }
    
    required init?(coder: NSCoder) {
        fatalError("init(coder:) has not been implemented")
    }
}

ContentView使用部分无需修改 #

import SwiftUI

struct ContentView: View{
    @State var offset: CGFloat = 10.0{
        didSet{
            print("Offset \(offset)")
        }
    }
    
    var body: some View{
        MyScrollView(offset: $offset){
            ZStack{
                Rectangle().foregroundColor(.clear).frame(width: 1200, height: 1000)
                Rectangle().foregroundColor(.blue).frame(width: 100, height: 100)
            }
        }
    }
}

额外说明 #

• 用Coordinator管理订阅生命周期，避免循环引用和内存泄漏
• 滚动偏移更新放在主队列异步执行，避免和SwiftUI的状态更新冲突
• 增加偏移量比较阈值，避免ScrollView滚动触发Binding更新，又反过来触发ScrollView滚动的死循环

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