非Xamarin.Forms环境下如何修改UITableView的Header背景色

解决方案 #

你之前的两种操作均未命中正确的修改对象：第一种修改的是右侧section索引条的背景，第二种修改的是UITableView整体的背景色，均不作用于section header视图本身。

方案1：通过代理方法动态生成自定义Header（通用方案） #

实现UITableViewDelegate的GetViewForHeader方法，自定义Header的样式：

public override UIView GetViewForHeader(UITableView tableView, nint section)
{
    // 复用Header视图
    var headerView = tableView.DequeueReusableHeaderFooterView("CustomHeader") 
        ?? new UITableViewHeaderFooterView(NSString.FromString("CustomHeader"));
    
    // 设置背景色：不要直接改headerView.BackgroundColor，需要配置backgroundView属性
    headerView.BackgroundView = new UIView { BackgroundColor = UIColor.Black };
    
    // 可选：自定义Header文字样式
    headerView.TextLabel.TextColor = UIColor.White;
    headerView.TextLabel.Text = $"第{section + 1}组";
    
    return headerView;
}

// 需同步设置Header高度，否则自定义视图不会正常显示
public override nfloat GetHeightForHeader(UITableView tableView, nint section)
{
    return 40; // 按需调整高度数值
}

在ViewDidLoad中补充配置：

// 绑定Delegate
TableView.Delegate = this;

// iOS15及以上版本需关闭默认Header顶部留白，避免出现多余灰色间隙
if (UIDevice.CurrentDevice.CheckSystemVersion(15, 0))
{
    TableView.SectionHeaderTopPadding = 0;
}

方案2：Xcode设计器静态配置 #

如果你使用Storyboard/Xib做静态Section布局：

• 展开UITableView的层级结构，找到对应Section的Header视图
• 直接给Header根视图的Background属性设置目标颜色即可

避坑提示 #

如果使用系统默认的Header视图，直接修改BackgroundColor属性会被系统默认样式覆盖，必须手动给BackgroundView赋值自定义视图后再修改背景色才会生效。

内容的提问来源于stack exchange，提问作者I.Weix