如何实现UITableViewHeaderView随滚动隐藏/显示的吸附效果（仿WhatsApp）

嘿，这个需求我太熟了！WhatsApp那个归档Header的丝滑交互确实很经典，先给你明确说：目前没有完全不用ScrollView代理的原生实现方式，不过我们可以把代理逻辑写得非常简洁，还能完美解决你遇到的Header覆盖Cell的问题。

先分析你当前代码的问题 #

你直接修改Header的frame高度，但没有让TableView重新计算contentSize，这就导致Header和Cell的布局重叠了。而且你只处理了下拉显示的逻辑，没覆盖向上滚动自动隐藏的吸附逻辑，阈值计算也不够通用（硬编码导航栏+状态栏高度容易适配出错）。

简化版实现方案（接近“无复杂代理”） #

下面的代码把代理逻辑压缩到最少，而且完全贴合WhatsApp的交互：

步骤1：初始化时隐藏Header #

先在ViewController里定义一个属性保存Header的原始高度，然后在viewDidLoad里初始化并隐藏它：

// 保存Header的原始高度，根据你的需求调整
private let originalHeaderHeight: CGFloat = 44

override func viewDidLoad() {
    super.viewDidLoad()
    
    // 初始化自定义Header
    let myHeader = MyTableViewHeaderFooterView()
    // 初始状态高度设为0，完全隐藏
    myHeader.frame = CGRect(
        x: 0,
        y: 0,
        width: tableView.bounds.width,
        height: 0
    )
    tableView.tableHeaderView = myHeader
}

步骤2：极简的ScrollView代理逻辑 #

只需要两个代理方法，就能实现下拉显示、轻微上滑自动吸附隐藏的效果：

override func scrollViewDidScroll(_ scrollView: UIScrollView) {
    guard let header = tableView.tableHeaderView as? MyTableViewHeaderFooterView else { return }
    
    // 计算下拉超出顶部的距离：当contentOffset.y小于-contentInset.top时，就是下拉超出了
    let pullDownDistance = max(-scrollView.contentOffset.y - scrollView.contentInset.top, 0)
    // 目标高度：最多不超过原始高度，最少为0
    let targetHeight = min(pullDownDistance, originalHeaderHeight)
    
    // 避免重复更新，提升性能
    guard header.frame.height != targetHeight else { return }
    
    // 更新Header高度
    header.frame.size.height = targetHeight
    // 关键！重新设置tableHeaderView，让TableView自动更新contentSize，避免覆盖Cell
    tableView.tableHeaderView = header
    
    // 调整contentOffset，防止Header高度变化导致列表跳动
    if targetHeight > 0 {
        scrollView.contentOffset = CGPoint(
            x: 0,
            y: -scrollView.contentInset.top - targetHeight
        )
    }
}

// 滚动结束后自动吸附：显示不足一半就隐藏，否则完全展开
override func scrollViewDidEndDragging(_ scrollView: UIScrollView, willDecelerate decelerate: Bool) {
    guard let header = tableView.tableHeaderView as? MyTableViewHeaderFooterView else { return }
    
    let shouldShowFullHeader = header.frame.height > originalHeaderHeight / 2
    
    UIView.animate(withDuration: 0.2) {
        header.frame.size.height = shouldShowFullHeader ? self.originalHeaderHeight : 0
        self.tableView.tableHeaderView = header
        
        // 同步调整contentOffset，保证滚动流畅
        if shouldShowFullHeader {
            scrollView.contentOffset = CGPoint(
                x: 0,
                y: -scrollView.contentInset.top - self.originalHeaderHeight
            )
        }
    }
}

为什么这个方案好用？ #

• 不用硬编码导航栏/状态栏高度，用scrollView.contentInset.top自动适配所有场景（刘海屏、隐藏导航栏等）
• 每次更新Header高度后重新设置tableHeaderView，让TableView自动计算contentSize，彻底解决覆盖Cell的问题
• 滚动结束的吸附逻辑完全模仿WhatsApp，半高判断的交互更符合用户习惯
• 代理逻辑非常简洁，几乎没有复杂计算，接近你想要的“无需复杂代理”的体验

至于你提到的旧版Swift/Xcode里的原生吸附效果，那确实是早期UITableView的一个隐藏特性，但后来苹果在系统更新中移除了，现在必须通过代理来实现这个交互。

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