TableView滚动时Navbar单向隐藏无法恢复，求解决方案

我翻遍了Stack Overflow的相关帖子找解决方案，但始终没能解决问题。iOS默认的navigationController.hidesBarsOnSwipe实现仅支持单向操作：向下滚动时导航栏会隐藏，但向上反向滚动时无法重新显示出来。

我的代码 #

class TaskVC: UIViewController {

@IBOutlet weak var tableview: UITableView!


var tasks: [Task] = [

    Task(title: "This is a Test Task", coins: 24, houseMate: "David"),
    Task(title: "This is a Test Task", coins: 25, houseMate: "David"),
    Task(title: "This is a Test Task",   coins: 26, houseMate: "David"),
    Task(title: "This is a Test Task", coins: 24, houseMate: "David"),
    Task(title: "This is a Test Task", coins: 25, houseMate: "David"),
    Task(title: "This is a Test Task",   coins: 26, houseMate: "David"),
    Task(title: "This is a Test Task", coins: 24, houseMate: "David"),
    Task(title: "This is a Test Task", coins: 25, houseMate: "David"),
    Task(title: "This is a Test Task",   coins: 26, houseMate: "David"),
    Task(title: "This is a Test Task", coins: 24, houseMate: "David")

]



override func viewDidLoad() {
    super.viewDidLoad()
    
    
    tableview.dataSource = self
    
    navigationController?.hidesBarsOnSwipe = true
    
    // 注册通过Nib创建的自定义表格单元格
    tableview.register(UINib(nibName: "TaskCell", bundle: nil), forCellReuseIdentifier: "ReusableCell")
    
    
}

表格视图Auto Layout约束 #

表格视图的顶部、底部、左侧、右侧均与父视图边缘完全对齐，无额外间距。

解决方案 #

1. 修正表格视图内边距设置 #

表格视图内边距异常会干扰导航栏的滑动检测逻辑，在viewDidLoad中添加：

tableview.contentInsetAdjustmentBehavior = .never
// 确保内边距匹配导航栏高度
if let navBarHeight = navigationController?.navigationBar.frame.height {
    tableview.contentInset = UIEdgeInsets(top: navBarHeight, left: 0, bottom: 0, right: 0)
    tableview.scrollIndicatorInsets = tableview.contentInset
}

2. 规范导航栏样式 #

导航栏半透明或线条设置不当可能导致检测失效，在viewWillAppear中添加：

override func viewWillAppear(_ animated: Bool) {
    super.viewWillAppear(animated)
    navigationController?.navigationBar.isTranslucent = true
    navigationController?.navigationBar.shadowImage = UIImage()
    navigationController?.navigationBar.setBackgroundImage(UIImage(), for: .default)
}

3. 自定义滚动监听（兜底方案） #

如果默认逻辑彻底失效，手动监听滚动控制导航栏：

override func viewDidLoad() {
    super.viewDidLoad()
    // 原有代码保留，关闭默认滑动隐藏逻辑
    navigationController?.hidesBarsOnSwipe = false
    tableview.delegate = self
}

extension TaskVC: UITableViewDelegate {
    func scrollViewDidScroll(_ scrollView: UIScrollView) {
        let currentOffset = scrollView.contentOffset.y
        let shouldHide = currentOffset > scrollView.lastOffset
        navigationController?.setNavigationBarHidden(shouldHide, animated: true)
        scrollView.lastOffset = currentOffset
    }
}

// 给UIScrollView扩展存储上次滚动位置
extension UIScrollView {
    private struct AssociatedKeys {
        static var lastOffsetKey = "lastOffsetKey"
    }
    
    var lastOffset: CGFloat {
        get { objc_getAssociatedObject(self, &AssociatedKeys.lastOffsetKey) as? CGFloat ?? 0 }
        set { objc_setAssociatedObject(self, &AssociatedKeys.lastOffsetKey, newValue, .OBJC_ASSOCIATION_RETAIN_NONATOMIC) }
    }
}

4. 排查滚动冲突 #

检查是否有其他手势识别器、自定义滚动代理方法（如scrollViewWillBeginDragging）干扰了默认检测逻辑，确保相关代码没有异常拦截滚动事件。

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