如何实现UITableView仅固定第0组头部且保留折叠展开功能？

这个需求我之前也碰到过，核心思路是借助plain样式的特性固定第0组头部，同时把第1组及以后的“头部”伪装成对应section的第一个cell，让它们自然跟随section滚动，避开系统的固定逻辑，同时保留折叠展开功能。下面是具体的实现步骤和代码示例：

利用UITableView plain样式仅固定系统section header的特性，让第0组使用系统header实现固定效果；对于其他组，用cell模拟header，这样这些“header”会和section内容一起滚动，完全匹配group样式的浮动行为。折叠展开则通过控制每个section的行数来实现。

1. 准备状态变量 #

在你的UITableView控制器/ViewModel中，维护两个数组分别记录每个section的展开状态和内容行数：

// 初始状态：第0组默认展开，其他组可按需设置
var sectionExpanded: [Bool] = [true, false, false]
// 每个section的内容行数（排除模拟header的行数）
var sectionContentRowCounts: [Int] = [5, 3, 4]

2. 配置UITableView样式 #

确保表格使用plain样式：

let tableView = UITableView(frame: view.bounds, style: .plain)
tableView.delegate = self
tableView.dataSource = self
view.addSubview(tableView)

3. 实现第0组的固定头部 #

第0组使用系统section header，自定义HeaderView并处理折叠点击：

自定义固定HeaderView #

class FixedSectionHeaderView: UITableViewHeaderFooterView {
    static let identifier = "FixedSectionHeaderView"
    
    var sectionIndex: Int = 0
    var tapHandler: ((Int) -> Void)?
    
    private let titleLabel = UILabel()
    private let arrowImageView = UIImageView(image: UIImage(systemName: "chevron.down"))
    
    override init(reuseIdentifier: String?) {
        super.init(reuseIdentifier: reuseIdentifier)
        setupLayout()
        addGestureRecognizer(UITapGestureRecognizer(target: self, action: #selector(headerTapped)))
    }
    
    required init?(coder: NSCoder) {
        fatalError("init(coder:) has not been implemented")
    }
    
    private func setupLayout() {
        // 布局标题和箭头，保持视觉统一
        contentView.backgroundColor = UIColor.systemGray6
        titleLabel.translatesAutoresizingMaskIntoConstraints = false
        arrowImageView.translatesAutoresizingMaskIntoConstraints = false
        
        contentView.addSubview(titleLabel)
        contentView.addSubview(arrowImageView)
        
        NSLayoutConstraint.activate([
            titleLabel.leadingAnchor.constraint(equalTo: contentView.leadingAnchor, constant: 16),
            titleLabel.centerYAnchor.constraint(equalTo: contentView.centerYAnchor),
            arrowImageView.trailingAnchor.constraint(equalTo: contentView.trailingAnchor, constant: -16),
            arrowImageView.centerYAnchor.constraint(equalTo: contentView.centerYAnchor)
        ])
    }
    
    @objc private func headerTapped() {
        tapHandler?(sectionIndex)
    }
    
    // 更新头部状态（比如箭头方向）
    func update(with title: String, isExpanded: Bool) {
        titleLabel.text = title
        arrowImageView.transform = isExpanded ? CGAffineTransform(rotationAngle: .pi) : .identity
    }
}

在控制器中注册并返回第0组header #

// 注册固定header
tableView.register(FixedSectionHeaderView.self, forHeaderFooterViewReuseIdentifier: FixedSectionHeaderView.identifier)

// 设置header高度：非第0组的系统header高度设为0，因为用cell模拟
func tableView(_ tableView: UITableView, heightForHeaderInSection section: Int) -> CGFloat {
    return section == 0 ? 50 : 0
}

// 返回第0组的headerView
func tableView(_ tableView: UITableView, viewForHeaderInSection section: Int) -> UIView? {
    guard section == 0 else { return nil }
    let header = tableView.dequeueReusableHeaderFooterView(withIdentifier: FixedSectionHeaderView.identifier) as! FixedSectionHeaderView
    header.sectionIndex = section
    header.tapHandler = { [weak self] section in
        self?.toggleSectionExpanded(section: section)
    }
    header.update(with: "第0组（固定头部）", isExpanded: sectionExpanded[section])
    return header
}

4. 用Cell模拟非第0组的浮动头部 #

对于第1组及以后的section，把“头部”作为该section的第0行cell：

模拟浮动Header的Cell #

class MockHeaderCell: UITableViewCell {
    static let identifier = "MockHeaderCell"
    
    var sectionIndex: Int = 0
    var tapHandler: ((Int) -> Void)?
    
    private let titleLabel = UILabel()
    private let arrowImageView = UIImageView(image: UIImage(systemName: "chevron.down"))
    
    override init(style: UITableViewCell.CellStyle, reuseIdentifier: String?) {
        super.init(style: style, reuseIdentifier: reuseIdentifier)
        setupLayout()
        addGestureRecognizer(UITapGestureRecognizer(target: self, action: #selector(cellTapped)))
        backgroundColor = UIColor.systemGray6
    }
    
    required init?(coder: NSCoder) {
        fatalError("init(coder:) has not been implemented")
    }
    
    private func setupLayout() {
        // 和固定header保持完全一致的布局
        titleLabel.translatesAutoresizingMaskIntoConstraints = false
        arrowImageView.translatesAutoresizingMaskIntoConstraints = false
        
        contentView.addSubview(titleLabel)
        contentView.addSubview(arrowImageView)
        
        NSLayoutConstraint.activate([
            titleLabel.leadingAnchor.constraint(equalTo: contentView.leadingAnchor, constant: 16),
            titleLabel.centerYAnchor.constraint(equalTo: contentView.centerYAnchor),
            arrowImageView.trailingAnchor.constraint(equalTo: contentView.trailingAnchor, constant: -16),
            arrowImageView.centerYAnchor.constraint(equalTo: contentView.centerYAnchor)
        ])
    }
    
    @objc private func cellTapped() {
        tapHandler?(sectionIndex)
    }
    
    func update(with title: String, isExpanded: Bool) {
        titleLabel.text = title
        arrowImageView.transform = isExpanded ? CGAffineTransform(rotationAngle: .pi) : .identity
    }
}

// 内容cell示例
class ContentCell: UITableViewCell {
    static let identifier = "ContentCell"
    
    private let contentLabel = UILabel()
    
    override init(style: UITableViewCell.CellStyle, reuseIdentifier: String?) {
        super.init(style: style, reuseIdentifier: reuseIdentifier)
        setupLayout()
    }
    
    required init?(coder: NSCoder) {
        fatalError("init(coder:) has not been implemented")
    }
    
    private func setupLayout() {
        contentLabel.translatesAutoresizingMaskIntoConstraints = false
        contentView.addSubview(contentLabel)
        
        NSLayoutConstraint.activate([
            contentLabel.leadingAnchor.constraint(equalTo: contentView.leadingAnchor, constant: 16),
            contentLabel.centerYAnchor.constraint(equalTo: contentView.centerYAnchor)
        ])
    }
    
    func configure(with text: String) {
        contentLabel.text = text
    }
}

注册Cell并处理行数和内容 #

// 注册模拟header的cell和内容cell
tableView.register(MockHeaderCell.self, forCellReuseIdentifier: MockHeaderCell.identifier)
tableView.register(ContentCell.self, forCellReuseIdentifier: ContentCell.identifier)

// 返回每个section的行数
func tableView(_ tableView: UITableView, numberOfRowsInSection section: Int) -> Int {
    if section == 0 {
        // 第0组：展开时返回内容行数，折叠时返回0
        return sectionExpanded[section] ? sectionContentRowCounts[section] : 0
    } else {
        // 非第0组：始终返回1（模拟header的cell） + 展开时的内容行数
        return 1 + (sectionExpanded[section] ? sectionContentRowCounts[section] : 0)
    }
}

// 返回对应cell
func tableView(_ tableView: UITableView, cellForRowAt indexPath: IndexPath) -> UITableViewCell {
    let section = indexPath.section
    if section != 0 && indexPath.row == 0 {
        // 非第0组的第0行：返回模拟header的cell
        let cell = tableView.dequeueReusableCell(withIdentifier: MockHeaderCell.identifier, for: indexPath) as! MockHeaderCell
        cell.sectionIndex = section
        cell.tapHandler = { [weak self] section in
            self?.toggleSectionExpanded(section: section)
        }
        cell.update(with: "第\(section)组（浮动头部）", isExpanded: sectionExpanded[section])
        return cell
    } else {
        // 内容cell：非第0组的内容行需要把row减1，跳过模拟header的行
        let contentRowIndex = section == 0 ? indexPath.row : indexPath.row - 1
        let cell = tableView.dequeueReusableCell(withIdentifier: ContentCell.identifier, for: indexPath) as! ContentCell
        cell.configure(with: "内容行\(contentRowIndex)")
        return cell
    }
}

5. 实现折叠展开切换逻辑 #

private func toggleSectionExpanded(section: Int) {
    sectionExpanded[section].toggle()
    // 刷新对应section，保留动画效果
    tableView.reloadSections(IndexSet(integer: section), with: .automatic)
}

6. 额外细节优化 #

• 视觉统一：模拟header的cell要和第0组的系统header保持完全一致的高度、背景色、字体等，避免视觉割裂。
• section间距：如果需要group样式的section间距，可以通过tableView(_:heightForFooterInSection:)设置非第0组的footer高度来模拟：

  func tableView(_ tableView: UITableView, heightForFooterInSection section: Int) -> CGFloat {
      return section != 0 ? 10 : 0
  }
  

• 安全区域适配：iOS 11+注意safeAreaInsets的影响，布局时要考虑顶部状态栏和底部导航栏的间距。

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