SwiftUI ScrollViewReader滚动至指定ID并添加偏移量的方案问询

iOS 17+ 推荐方案：使用scrollDestination #

从iOS 17开始，SwiftUI提供了原生的scrollDestination(for:)修饰符，可直接自定义滚动到指定ID的目标位置，无需额外占位视图：

1. 为ScrollView添加scrollDestination修饰符，针对你的ID类型（示例中为TabID）定义偏移后的滚动位置：

ScrollView {
    ScrollViewReader { proxy in
        // 你的内容视图集合，每个目标视图需标记对应ID
        ForEach(tabs) { tab in
            TabContent(tab: tab)
                .id(tab.id)
        }
    }
}
.scrollDestination(for: TabID.self) { tabId in
    // 获取目标视图的全局坐标
    guard let targetFrame = proxy.frame(for: tabId) else {
        return .unavailable
    }
    // 计算偏移：目标视图顶部向上偏移50，避开粘性标签栏
    return .absolute(targetFrame.minY - 50)
}

2. 调用滚动的代码保持原有逻辑即可：

withAnimation(.linear(duration: animationDuration)) {
    scrollViewReader.scrollTo(tab.id)
}

该方案完全基于原生API，既不破坏布局，也能精准控制滚动偏移量。

兼容iOS 16及以下的方案：调整底层UIScrollView偏移 #

如果需要兼容更低版本，可通过获取底层UIKit滚动视图手动调整偏移：

1. 为ScrollView设置自定义坐标空间，方便定位目标滚动视图：

ScrollView {
    ScrollViewReader { proxy in
        // 你的内容视图集合
    }
}
.coordinateSpace(name: "CustomScrollView")

2. 在scrollTo执行后，延迟调整底层滚动视图的偏移量：

withAnimation(.linear(duration: animationDuration)) {
    scrollViewReader.scrollTo(tab.id, anchor: .top)
    
    // 等待滚动动画完成后调整偏移（可根据动画时长调整延迟）
    DispatchQueue.main.asyncAfter(deadline: .now() + animationDuration) {
        if let scrollView = UIApplication.shared.connectedScenes
            .compactMap({ $0 as? UIWindowScene })
            .first?.windows
            .first?.rootViewController?.view
            .subviews
            .first(where: { $0 is UIScrollView && $0.coordinateSpace.name == "CustomScrollView" }) as? UIScrollView {
            // 减去50偏移量，避免视图被标签栏遮挡
            scrollView.contentOffset.y -= 50
        }
    }
}

注意：该方案依赖底层UIKit视图，稳定性略逊于iOS 17+的原生方案，优先推荐前者。

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