如何使用UIScrollView滚动到首个视图顶部实现图片置顶

滚动逻辑不生效、图片始终停在导航栏下方，核心是两个问题：

• 调用时机错误：viewDidLoad 阶段AutoLayout还没完成布局，scrollView的frame、系统自动注入的adjustedContentInset都没最终确定，此时调用滚动方法拿不到正确的位置参数，执行无效。
• 系统默认行为：当页面存在UINavigationBar时，系统会自动给scrollView添加高度等于「状态栏+导航栏」的顶部内边距，把scrollView内容往下推；再加上市面默认的导航栏是不透明的，就算内容顶到屏幕顶部也会被导航栏挡住。

不需要依赖你写的scrollToView扩展，按下面配置就能实现图片固定在屏幕最顶部、导航栏悬浮在图片上方的效果：

1. 配置透明导航栏 #

首先把导航栏设为透明，保证下层的图片能穿透显示，在viewDidLoad里添加如下代码：

override func viewDidLoad() {
    super.viewDidLoad()
    setupViews()
    // 配置透明导航栏
    navigationController?.navigationBar.setBackgroundImage(UIImage(), for: .default)
    navigationController?.navigationBar.shadowImage = UIImage()
    navigationController?.navigationBar.isTranslucent = true
}

2. 正确时机设置初始滚动位置 #

不要在viewDidLoad里触发滚动，等布局完成后把scrollView的偏移量设到最顶部即可，加个标记位保证逻辑只执行一次：

// 新增标记位，避免重复触发滚动
private var hasSetInitialOffset = false

override func viewDidLayoutSubviews() {
    super.viewDidLayoutSubviews()
    guard !hasSetInitialOffset else { return }
    hasSetInitialOffset = true
    // 滚动到最顶部，抵消系统自动添加的顶部内边距
    let topOffset = CGPoint(x: 0, y: -scrollView.adjustedContentInset.top)
    scrollView.setContentOffset(topOffset, animated: false)
}

你的UIImageView本来就约束在scrollView的最顶部，不需要额外计算子视图位置，直接设置偏移量的方式比原扩展的坐标转换逻辑更稳定，不会受AutoLayout布局时机影响。

3. （可选）添加滑动时导航栏渐变效果 #

如果需要页面上滑、图片逐渐被导航栏遮挡时，导航栏从透明平滑过渡到不透明，可以实现UIScrollViewDelegate代理方法：

// 先在viewDidLoad里设置代理
scrollView.delegate = self

extension MealDetailsVC: UIScrollViewDelegate {
    func scrollViewDidScroll(_ scrollView: UIScrollView) {
        // 计算当前滑动偏移量，扣除系统内边距
        let currentOffset = scrollView.contentOffset.y + scrollView.adjustedContentInset.top
        // 导航栏完全不透明的滑动阈值 = 图片高度 - 导航栏总高度
        let navTotalHeight = (navigationController?.navigationBar.frame.height ?? 44) + UIApplication.shared.statusBarFrame.height
        let imageHeight = UIScreen.main.bounds.width * 0.6
        let alphaThreshold = imageHeight - navTotalHeight
        // 计算导航栏透明度，限制在0-1区间
        let navAlpha = min(1, max(0, currentOffset / alphaThreshold))
        navigationController?.navigationBar.alpha = navAlpha
    }
}

如果图片下方还有其他文本、按钮之类的内容，只需要把这部分内容的顶部约束设为距离scrollView顶部navTotalHeight的偏移量，就能保证初始状态下文字不会被导航栏挡住，滑动时和图片一起正常滚动。

你之前写的UIScrollView扩展除了调用时机太早的问题，还存在适配缺陷：代码通过view.frame做坐标转换，但Auto布局下viewDidLoad阶段所有视图的frame默认都是.zero，就算延后调用时机，遇到嵌套子视图的场景也很容易算错坐标，针对「滚到顶部」这种通用场景，直接用adjustedContentInset设置contentOffset是兼容性最高的方案。

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