自定义UITabBarController中UITabBar的滚动边缘外观/底部淡入效果无法正常工作

我太懂你这种头疼的感觉了——核心逻辑都跑通了，偏偏系统自带的滚动边缘效果死活不出来，对吧？其实问题的根源在于：系统原生的UITabBarController会自动帮我们完成滚动视图和TabBar之间的关联绑定，而你的自定义实现里刚好漏掉了这层关键的联动逻辑。

我帮你拆解一下问题，再给出具体的修改方案：

核心缺失点 #

系统的UITabBarController会做三件你没做的事：

1. 自动调整子控制器视图的布局范围，让内容不会被TabBar遮挡，同时允许内容滚动到TabBar下方
2. 给滚动视图设置正确的contentInset和scrollIndicatorInsets，适配TabBar的高度
3. 监听滚动视图的滚动状态，自动切换TabBar的standardAppearance和scrollEdgeAppearance

具体修改步骤 #

1. 修正子控制器的布局约束 #

首先，你不能让子控制器的view直接贴到整个容器的底部，要给TabBar留出空间：

private func addViewController(_ controller: UIViewController?) {
    guard let controller = controller else { return }
    addChild(controller)
    controller.view.translatesAutoresizingMaskIntoConstraints = false
    view.addSubview(controller.view)
    
    NSLayoutConstraint.activate([
        controller.view.leadingAnchor.constraint(equalTo: view.leadingAnchor),
        controller.view.trailingAnchor.constraint(equalTo: view.trailingAnchor),
        controller.view.topAnchor.constraint(equalTo: view.topAnchor),
        // 关键修改：子视图底部贴到TabBar顶部，而非容器底部
        controller.view.bottomAnchor.constraint(equalTo: tabBar.topAnchor),
    ])
    
    controller.didMove(toParent: self)
    view.bringSubviewToFront(tabBar)
    
    // 新增：给当前控制器的滚动视图做适配
    configureScrollViewForTabBar(controller: controller)
}

2. 配置滚动视图的适配参数 #

添加一个专门的方法，处理滚动视图的偏移和监听：

private func configureScrollViewForTabBar(controller: UIViewController) {
    // 这里假设你的子控制器是UINavigationController包裹的UITableViewController
    // 如果是其他类型的滚动视图（比如UICollectionView/UIScrollView），需要调整遍历逻辑
    guard let navController = controller as? UINavigationController,
          let tableVC = navController.topViewController as? UITableViewController,
          let scrollView = tableVC.tableView else {
        return
    }
    
    let tabBarHeight = tabBar.frame.height
    // 让内容可以滚动到TabBar下方
    scrollView.contentInset.bottom = tabBarHeight
    scrollView.scrollIndicatorInsets.bottom = tabBarHeight
    // 让系统自动处理安全区域偏移
    scrollView.contentInsetAdjustmentBehavior = .automatic
    
    // 绑定滚动代理，用来监听滚动状态切换TabBar外观
    scrollView.delegate = self
}

3. 监听滚动事件，切换TabBar外观 #

让你的MyTabBarController遵守UIScrollViewDelegate，并实现滚动监听：

extension MyTabBarController: UIScrollViewDelegate {
    func scrollViewDidScroll(_ scrollView: UIScrollView) {
        let contentOffsetY = scrollView.contentOffset.y
        let contentTotalHeight = scrollView.contentSize.height + scrollView.contentInset.bottom
        let scrollViewVisibleHeight = scrollView.bounds.height
        
        // 判断是否滚动到了底部边缘
        let isAtBottomEdge = contentOffsetY + scrollViewVisibleHeight >= contentTotalHeight
        
        // 切换TabBar外观
        if isAtBottomEdge {
            tabBar.standardAppearance = tabBar.scrollEdgeAppearance ?? tabBar.standardAppearance
        } else {
            // 还原默认背景外观
            let defaultAppearance = UITabBarAppearance()
            defaultAppearance.configureWithDefaultBackground()
            tabBar.standardAppearance = defaultAppearance
        }
    }
}

4. 统一TabBar的布局约束（可选但推荐） #

你可以把iOS版本分支的约束简化，iOS15+的TabBar会自动处理安全区域：

private func setupTabBar() {
    let std = UITabBarAppearance()
    std.configureWithDefaultBackground()
    tabBar.standardAppearance = std
    
    let se = UITabBarAppearance()
    se.configureWithTransparentBackground()
    tabBar.scrollEdgeAppearance = se
    
    tabBar.delegate = self
    tabBar.translatesAutoresizingMaskIntoConstraints = false
    view.addSubview(tabBar)
    
    NSLayoutConstraint.activate([
        tabBar.leadingAnchor.constraint(equalTo: view.leadingAnchor),
        tabBar.trailingAnchor.constraint(equalTo: view.trailingAnchor),
        tabBar.bottomAnchor.constraint(equalTo: view.bottomAnchor),
        // 固定TabBar高度，避免布局异常
        tabBar.heightAnchor.constraint(equalToConstant: UITabBar.appearance().frame.height)
    ])
}

5. 切换Tab时重新绑定滚动代理 #

在TabBar的代理方法里，给新选中的控制器重新配置滚动视图：

extension MyTabBarController: UITabBarDelegate {
    func tabBar(_ tabBar: UITabBar, didSelect item: UITabBarItem) {
        guard let index = tabBar.items?.firstIndex(of: item), index != selectedIndex else { return }
        selectViewController(at: index)
        
        // 给新选中的控制器配置滚动视图
        if let currentVC = _viewControllers[selectedIndex] {
            configureScrollViewForTabBar(controller: currentVC)
        }
    }
}

为什么这些修改有效？ #

• 调整布局约束后，子控制器的内容不会被TabBar遮挡，滚动视图的滚动范围变得合理
• 设置contentInset让内容可以滚动到TabBar下方，触发系统的边缘识别逻辑（iOS26的淡入效果依赖这个）
• 通过监听滚动事件手动切换TabBar外观，模拟了系统UITabBarController的原生行为

如果你的子控制器不是导航+表视图的组合，只需要调整configureScrollViewForTabBar方法里的滚动视图查找逻辑即可，比如直接遍历子控制器的view找到UIScrollView类型的视图。

内容来源于stack exchange