如何修改UITableViewHeaderFooterView的textLabel高度？字体设置后内容被遮挡

我之前也碰到过这个情况，默认的UITableViewHeaderFooterView的textLabel在修改字体后很容易出现文本截断的问题——核心原因是系统给这个label预设了固定布局约束，字体变化后，label的高度没自动适配文本内容。下面给你两种实用的解决方案：

方案一：调整默认HeaderView的布局 #

在willDisplayHeaderView方法里，除了设置字体，手动更新label的布局和header的高度，确保文本能完整显示：

- (void)tableView:(UITableView *)tableView willDisplayHeaderView:(UIView *)view forSection:(NSInteger)section {
    UITableViewHeaderFooterView *header = (UITableViewHeaderFooterView *)view;
    
    // 设置目标字体
    header.textLabel.font = [UIFont fontWithName:@"Damascus" size:13];
    
    // 允许文本自动换行（如果标题是多行内容的话）
    header.textLabel.numberOfLines = 0;
    
    // 让label根据内容自动调整大小
    [header.textLabel sizeToFit];
    
    // 调整header的高度，给文本留出上下内边距（这里的16可以根据你的需求调整）
    CGRect updatedFrame = header.frame;
    updatedFrame.size.height = header.textLabel.frame.size.height + 16;
    header.frame = updatedFrame;
    
    // 强制header重新布局，确保生效
    [header layoutIfNeeded];
}

方案二：使用自定义HeaderView（更推荐） #

如果需要频繁自定义header样式，直接做一个UITableViewHeaderFooterView子类会更灵活，能完全控制布局，避免系统默认约束的限制：

1. 先注册自定义HeaderView #

在viewDidLoad里完成注册：

- (void)viewDidLoad {
    [super viewDidLoad];
    // 注册自定义header的复用标识
    [self.tableView registerClass:[CustomSectionHeader class] forHeaderFooterViewReuseIdentifier:@"CustomSectionHeaderID"];
}

2. 实现自定义HeaderView类 #

// CustomSectionHeader.h
#import <UIKit/UIKit.h>

@interface CustomSectionHeader : UITableViewHeaderFooterView
@property (nonatomic, strong) UILabel *titleLabel;
@end

// CustomSectionHeader.m
#import "CustomSectionHeader.h"

@implementation CustomSectionHeader

- (instancetype)initWithReuseIdentifier:(NSString *)reuseIdentifier {
    self = [super initWithReuseIdentifier:reuseIdentifier];
    if (self) {
        // 创建自定义标题label
        self.titleLabel = [[UILabel alloc] initWithFrame:CGRectZero];
        self.titleLabel.translatesAutoresizingMaskIntoConstraints = NO;
        self.titleLabel.numberOfLines = 0; // 允许文本换行
        self.titleLabel.font = [UIFont fontWithName:@"Damascus" size:13]; // 直接设置目标字体
        
        [self.contentView addSubview:self.titleLabel];
        
        // 添加约束，确保label在contentView内有足够的显示空间
        [NSLayoutConstraint activateConstraints:@[
            self.titleLabel.leadingAnchor.constraintEqualToAnchor:self.contentView.leadingAnchor constant:16,
            self.titleLabel.trailingAnchor.constraintEqualToAnchor:self.contentView.trailingAnchor constant:-16,
            self.titleLabel.topAnchor.constraintEqualToAnchor:self.contentView.topAnchor constant:8,
            self.titleLabel.bottomAnchor.constraintEqualToAnchor:self.contentView.bottomAnchor constant:-8
        ]];
    }
    return self;
}

@end

3. 在TableView代理方法里返回自定义Header #

- (UIView *)tableView:(UITableView *)tableView viewForHeaderInSection:(NSInteger)section {
    CustomSectionHeader *header = [tableView dequeueReusableHeaderFooterViewWithIdentifier:@"CustomSectionHeaderID"];
    header.titleLabel.text = @"fa..."; // 设置你的标题文本
    return header;
}

// 设置header的自动高度（或者固定一个合适的高度）
- (CGFloat)tableView:(UITableView *)tableView heightForHeaderInSection:(NSInteger)section {
    return UITableViewAutomaticDimension;
}

这样就能彻底解决文本被遮挡的问题，后续调整样式也会更方便。

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