如何复刻scrollsToTop行为，滚动UIScrollView显示大标题导航栏及UISearchBar？

我完全懂你的痛点——系统默认的scrollsToTop行为确实只会把滚动视图滚到顶部，但不会触发hidesSearchBarWhenScrolling = true时的搜索栏展开动画，大标题导航栏虽然能显示，但搜索栏就是藏着不出来。下面是我验证过的可行方案，完美复刻系统原生的流畅体验：

核心思路 #

系统的搜索栏展开逻辑依赖于滚动视图的偏移量变化：只有当滚动视图从「偏移量大于导航栏最小高度对应的位置」滚动到「偏移量小于该位置」时，才会触发搜索栏的展开动画。直接滚到contentOffset.y = 0不会触发这个状态变化，所以我们需要模拟一个「先滚过顶部，再回到顶部」的动画，让系统自动触发搜索栏展开。

具体实现步骤 #

1. 禁用默认的scrollsToTop行为 #

首先把你的UITableView/UICollectionView的scrollsToTop设为false，同时确保当前控制器是滚动视图的代理：

override func viewDidLoad() {
    super.viewDidLoad()
    
    // 配置滚动视图
    tableView.scrollsToTop = false
    tableView.delegate = self
    
    // 配置大标题和搜索栏
    navigationController?.navigationBar.prefersLargeTitles = true
    let searchController = UISearchController(searchResultsController: nil)
    navigationItem.searchController = searchController
    navigationItem.hidesSearchBarWhenScrolling = true
}

2. 拦截状态栏点击事件，自定义滚动逻辑 #

实现UIScrollViewDelegate的scrollViewShouldScrollToTop方法，返回false来阻止默认行为，然后手动执行分阶段的滚动动画：

func scrollViewShouldScrollToTop(_ scrollView: UIScrollView) -> Bool {
    // 计算需要滚动到的「超顶部」位置，包含导航栏高度和安全区域顶部高度
    let overTopOffset = CGPoint(
        x: 0,
        y: -(navigationController!.navigationBar.bounds.height + view.safeAreaInsets.top)
    )
    
    // 第一阶段：滚动到超顶部，触发搜索栏展开
    UIView.animate(withDuration: 0.3, animations: {
        scrollView.contentOffset = overTopOffset
    }) { _ in
        // 第二阶段：平滑滚回顶部，保持搜索栏展开状态
        UIView.animate(withDuration: 0.2) {
            scrollView.contentOffset = .zero
        }
    }
    
    return false
}

关键细节说明 #

• 超顶部偏移量的计算：加上view.safeAreaInsets.top是为了适配刘海屏的状态栏高度，确保滚动的位置足够触发系统的搜索栏展开逻辑。
• 动画时长：第一阶段用0.3秒（和系统默认滚动动画时长一致），第二阶段用0.2秒，整体体验和原生行为几乎无差别。
• 代理设置：一定要确保你的控制器是滚动视图的代理，否则scrollViewShouldScrollToTop方法不会被调用。

这样操作后，点击状态栏时，滚动视图会先快速滚过顶部（视觉上几乎察觉不到），然后平滑回到顶部，同时大标题导航栏完全展开，嵌入的搜索栏也会跟着优雅地滑出来，完美复刻系统原生的交互效果。

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