Xamarin.iOS中UITableView滚动至顶部时Header/导航标题消失问题

该异常是iOS 11及以上版本导航栏大标题（Large Title）模式配置错误导致的。当前页面大概率开启了导航栏大标题属性，但未正确匹配滚动视图的安全区适配规则，同时可能存在自定义的导航栏显示/隐藏逻辑和系统原生行为冲突，才会出现顶部静止时标题不渲染、滚动时才触发标题显示的问题。

完全基于UIKit原生能力实现，不需要自定义滚动监听逻辑，性能最优无卡顿：

第一步：配置导航栏基础属性 #

在页面的ViewDidLoad生命周期方法中添加如下配置，修正大标题的显示规则：

public override void ViewDidLoad()
{
    base.ViewDidLoad();
    // 开启导航栏大标题支持
    NavigationController.NavigationBar.PrefersLargeTitles = true;
    // 配置当前页面始终允许大标题展示，滚动时自动折叠
    NavigationItem.LargeTitleDisplayMode = UINavigationItemLargeTitleDisplayMode.Always;
    // 保留导航栏半透明特性，保证滚动时的层级效果正常
    NavigationController.NavigationBar.Translucent = true;
    NavigationController.NavigationBar.BarTintColor = UIColor.White;
    // 设置页面导航标题
    Title = "你的业务页面标题";

    // 初始化TableView配置
    ConfigTableView();
}

第二步：适配TableView安全区 #

不要手动写死TableView的内容偏移，交给系统自动计算导航栏、状态栏的占位高度，避免大标题区域被内容遮挡：

private void ConfigTableView()
{
    // 自动适配滚动视图的安全区内边距
    TableView.ContentInsetAdjustmentBehavior = UIScrollViewContentInsetAdjustmentBehavior.Always;
    
    // 注意：删除之前自己实现的UIScrollViewDelegate中手动控制导航栏透明度、显隐的代码
    // 这部分自定义逻辑是和系统原生大标题滚动效果冲突的核心原因
}

如果配置后仍有异常，逐一检查以下错误配置：

• 删除手动给TableView设置ContentInset = new UIEdgeInsets(0, 0, 0, 0)的代码，手动置顶的内边距会把大标题区域顶出屏幕可视范围
• 不要给当前NavigationItem设置自定义TitleView，自定义标题视图会打断系统大标题的原生渲染逻辑
• 检查父级容器页面（比如UITabBarController、嵌套的UINavigationController）是否错误配置了PrefersLargeTitles = false，父级配置会覆盖子页面的设置
• 检查ViewWillAppear、ViewWillDisappear生命周期中是否存在手动修改导航栏Hidden属性、添加透明度渐变动画的逻辑，这类逻辑会干扰大标题的正常显示

配置完成后即可完全匹配预期交互：

• 页面静止在TableView顶部位置时，大标题正常展示在列表上方，右侧导航栏按钮正常显示
• 向下滚动列表时，大标题会自动平滑折叠到导航栏的标题位置，实现标题隐入导航栏的效果
• 所有交互由UIKit原生实现，无额外性能损耗，不会出现滚动卡顿、标题显示异常的问题

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