隐藏导航栏导致其下方与视图上方出现间隙

我之前也碰到过这个超棘手的布局冲突！当hidesBarsOnSwipe和UITableView的固定section header同时启用时，系统的布局协调逻辑确实会掉链子，导致导航栏隐藏过程中section header和导航栏之间露出表格背景的间隙。下面是我亲测有效的几种解决方案，你可以根据自己的代码结构选合适的：

方案一：监听导航栏状态，动态调整Section Header约束 #

这种方式适合用了自定义Section Header的场景，通过同步导航栏的显示/隐藏状态来调整header的位置：

1. 先给你的自定义Section Header（比如StickySectionHeaderView）添加一个顶部约束的引用，方便后续修改
2. 在ViewController中设置导航栏代理，监听导航栏的显示状态变化
3. 同步调整Section Header的顶部约束，让它跟着导航栏一起移动

class YourViewController: UIViewController, UINavigationControllerDelegate {
    @IBOutlet weak var tableView: UITableView!

    override func viewDidLoad() {
        super.viewDidLoad()
        navigationController?.delegate = self
        navigationController?.hidesBarsOnSwipe = true
        // 初始化自定义header的顶部约束，默认贴合导航栏底部
        if let header = tableView.tableHeaderView as? StickySectionHeaderView {
            header.topConstraint.constant = navigationController?.navigationBar.frame.height ?? 0
        }
    }

    func navigationController(_ navigationController: UINavigationController, didShow viewController: UIViewController, animated: Bool) {
        guard let header = tableView.tableHeaderView as? StickySectionHeaderView else { return }
        let targetConstant = navigationController.isNavigationBarHidden ? 0 : navigationController.navigationBar.frame.height
        
        // 用和系统一致的动画时长，保证过渡自然
        UIView.animate(withDuration: 0.3) {
            header.topConstraint.constant = targetConstant
            header.layoutIfNeeded()
        }
    }
}

方案二：通过TableView内容偏移量同步调整 #

如果用的是系统默认的Section Header，不想自定义的话，可以通过调整tableView的contentInset来解决：

class YourViewController: UIViewController {
    @IBOutlet weak var tableView: UITableView!

    override func viewDidLoad() {
        super.viewDidLoad()
        navigationController?.hidesBarsOnSwipe = true
        // 初始设置内容内边距，让header贴合导航栏
        updateTableViewInsets()
        
        // 监听导航栏隐藏状态变化的通知
        NotificationCenter.default.addObserver(
            self,
            selector: #selector(navBarVisibilityChanged),
            name: UINavigationController.isNavigationBarHiddenDidChangeNotification,
            object: navigationController
        )
    }

    @objc private func navBarVisibilityChanged(_ notification: Notification) {
        updateTableViewInsets(animated: true)
    }

    private func updateTableViewInsets(animated: Bool = false) {
        let navBarHeight = navigationController?.navigationBar.frame.height ?? 0
        let topInset = navigationController?.isNavigationBarHidden ?? false ? 0 : navBarHeight
        
        let updateBlock = {
            self.tableView.contentInset.top = topInset
            self.tableView.scrollIndicatorInsets.top = topInset
        }
        
        if animated {
            UIView.animate(withDuration: 0.3, animations: updateBlock)
        } else {
            updateBlock()
        }
    }
}

方案三：自定义滑动手势，完全控制动画节奏 #

如果想更精细地控制导航栏和header的联动动画，可以禁用系统的hidesBarsOnSwipe，自己实现滑动手势逻辑：

class YourViewController: UIViewController {
    @IBOutlet weak var tableView: UITableView!

    override func viewDidLoad() {
        super.viewDidLoad()
        // 禁用系统默认的滑动隐藏
        navigationController?.hidesBarsOnSwipe = false
        
        // 添加自定义向上滑动手势
        let swipeUp = UISwipeGestureRecognizer(target: self, action: #selector(toggleNavBar))
        swipeUp.direction = .up
        tableView.addGestureRecognizer(swipeUp)
        
        // 添加向下滑动手势恢复导航栏
        let swipeDown = UISwipeGestureRecognizer(target: self, action: #selector(toggleNavBar))
        swipeDown.direction = .down
        tableView.addGestureRecognizer(swipeDown)
    }

    @objc private func toggleNavBar() {
        let isHidden = navigationController?.isNavigationBarHidden ?? false
        let navBarHeight = navigationController?.navigationBar.frame.height ?? 0
        
        UIView.animate(withDuration: 0.3) {
            self.navigationController?.setNavigationBarHidden(!isHidden, animated: false)
            
            // 同步调整tableView的内容偏移，让header无缝跟随
            self.tableView.contentOffset.y += isHidden ? navBarHeight : -navBarHeight
        }
    }
}

额外注意点 #

• 如果你用的是iOS 13+的大标题导航栏，记得动态获取导航栏高度，不要硬编码数值
• 动画时长尽量和系统默认的0.3秒保持一致，避免视觉上的割裂感
• 如果是分组tableView的section header，建议把它改成tableView的tableHeaderView来处理，更容易控制布局

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