如何隐藏/显示UITableView表头视图与详情单元格？及代理外访问方法

一、控制表头视图（Header View）的显隐 #

• 动态返回表头（推荐）
  定义一个布尔变量控制显隐状态，在代理方法中判断返回内容：

  var isHeaderVisible = true
  
  func tableView(_ tableView: UITableView, viewForHeaderInSection section: Int) -> UIView? {
      guard isHeaderVisible else { return nil }
      // 复用或创建自定义表头视图
      let headerView = tableView.dequeueReusableHeaderFooterView(withIdentifier: "CustomHeaderID") as! CustomHeaderView
      headerView.titleLabel.text = "表头标题"
      return headerView
  }
  
  func tableView(_ tableView: UITableView, heightForHeaderInSection section: Int) -> CGFloat {
      return isHeaderVisible ? 60 : 0 // 隐藏时高度设为0避免留白
  }
  

  切换状态时，修改变量后刷新对应分组：

  isHeaderVisible.toggle()
  tableView.reloadSections([0], with: .fade)
  

• 直接操作已存在的表头
  如果表头已加载，可直接修改其显隐属性，同时更新布局：

  if let headerView = tableView.headerView(forSection: 0) {
      headerView.isHidden = !headerView.isHidden
      tableView.beginUpdates()
      tableView.endUpdates()
  }
  

二、控制详情单元格（Detailed Cell）的显隐 #

• 通过数据源动态调整行数
  用变量标记详情单元格的显隐状态，在数据源方法中控制返回行数：

  var isDetailCellVisible = false
  let baseCellCount = 2 // 普通单元格数量
  
  func tableView(_ tableView: UITableView, numberOfRowsInSection section: Int) -> Int {
      return baseCellCount + (isDetailCellVisible ? 1 : 0)
  }
  
  func tableView(_ tableView: UITableView, cellForRowAt indexPath: IndexPath) -> UITableViewCell {
      if indexPath.row == baseCellCount && isDetailCellVisible {
          // 返回详情单元格
          let cell = tableView.dequeueReusableCell(withIdentifier: "DetailedCellID", for: indexPath) as! DetailedCell
          cell.detailLabel.text = "详情内容"
          return cell
      } else {
          // 返回普通单元格
          let cell = tableView.dequeueReusableCell(withIdentifier: "NormalCellID", for: indexPath) as! NormalCell
          cell.textLabel?.text = "普通单元格\(indexPath.row)"
          return cell
      }
  }
  

  切换状态时，用插入/删除行实现动画效果：

  isDetailCellVisible.toggle()
  let detailIndexPath = IndexPath(row: baseCellCount, section: 0)
  if isDetailCellVisible {
      tableView.insertRows(at: [detailIndexPath], with: .fade)
  } else {
      tableView.deleteRows(at: [detailIndexPath], with: .fade)
  }
  

三、在代理方法外部访问UITableViewCell #

• 通过indexPath获取（仅适用于可见单元格）
  若已知目标单元格的indexPath，直接调用方法获取：

  let targetIndexPath = IndexPath(row: baseCellCount, section: 0)
  if let detailCell = tableView.cellForRow(at: targetIndexPath) as? DetailedCell {
      // 操作单元格，比如修改显隐或内容
      detailCell.isHidden = !detailCell.isHidden
      // 若需调整布局，触发更新
      tableView.beginUpdates()
      tableView.endUpdates()
  }
  

  注意：单元格不在屏幕内时，cellForRow(at:)会返回nil。

• 遍历可见单元格筛选
  针对当前屏幕上的单元格，按标识符筛选：

  for cell in tableView.visibleCells {
      if cell.reuseIdentifier == "DetailedCellID" {
          cell.isHidden = !cell.isHidden
      }
  }
  

• 通过数据源模型关联状态
  给数据源模型添加显隐属性，在cellForRowAt中同步状态，代理外修改模型后刷新单元格：

  // 数据源模型
  struct CellItem {
      var title: String
      var isVisible: Bool = true
      var isDetailItem: Bool = false
  }
  
  var cellItems: [CellItem] = [
      CellItem(title: "普通项1"),
      CellItem(title: "普通项2"),
      CellItem(title: "详情项", isVisible: false, isDetailItem: true)
  ]
  
  // 配置单元格
  func tableView(_ tableView: UITableView, cellForRowAt indexPath: IndexPath) -> UITableViewCell {
      let item = cellItems[indexPath.row]
      let cellIdentifier = item.isDetailItem ? "DetailedCellID" : "NormalCellID"
      let cell = tableView.dequeueReusableCell(withIdentifier: cellIdentifier, for: indexPath)
      cell.isHidden = !item.isVisible
      return cell
  }
  
  // 代理外修改状态
  cellItems[2].isVisible.toggle()
  tableView.reloadRows(at: [IndexPath(row: 2, section: 0)], with: .automatic)
  

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