UITableView-FDTemplateLayoutCell常见问题解答：从入门到实战的避坑指南-优快云博客

UITableView-FDTemplateLayoutCell常见问题解答：从入门到实战的避坑指南

【免费下载链接】UITableView-FDTemplateLayoutCell Template auto layout cell for automatically UITableViewCell height calculating 项目地址: https://gitcode.com/gh_mirrors/ui/UITableView-FDTemplateLayoutCell

UITableView-FDTemplateLayoutCell是一个用于自动计算UITableViewCell高度的开源库，能帮助开发者轻松实现动态单元格高度。本文将解答使用过程中的常见问题，从基础用法到高级缓存，助你避开各种陷阱。

基础使用与核心概念

什么是"自满足单元格（self-satisfied cell）"？

自满足单元格是指通过自动布局（Auto Layout）约束，每个边缘（上、左、下、右）至少有一个布局约束与其关联的单元格。这是iOS8中引入的"自调整大小单元格（self-sizing cell）"的同一概念。

错误示例（缺少右和底部约束）：

要创建自满足单元格，需确保内容视图的约束能完全确定其高度，如Classes/UITableView+FDTemplateLayoutCell.h中所述。

基本使用方法

如果已有自满足单元格，只需在-tableView:heightForRowAtIndexPath:方法中使用以下代码：

#import "UITableView+FDTemplateLayoutCell.h"

- (CGFloat)tableView:(UITableView *)tableView heightForRowAtIndexPath:(NSIndexPath *)indexPath
{
    return [tableView fd_heightForCellWithIdentifier:@"reuse identifer" configuration:^(id cell) {
        // 配置单元格数据，与在"-tableView:cellForRowAtIndexPath:"中相同
        // 例如:
        // cell.entity = self.feedEntities[indexPath.row];
    }];
}

高度缓存机制

为什么需要缓存？

从iOS8开始，-tableView:heightForRowAtIndexPath:的调用次数比预期多，滚动时会感觉到这些额外计算的影响。因此，库提供了带缓存的API，如Classes/UITableView+FDIndexPathHeightCache.h和Classes/UITableView+FDKeyedHeightCache.h中定义的方法。

按索引路径缓存

- (CGFloat)tableView:(UITableView *)tableView heightForRowAtIndexPath:(NSIndexPath *)indexPath {
    return [tableView fd_heightForCellWithIdentifier:@"identifer" cacheByIndexPath:indexPath configuration:^(id cell) {
        // 配置单元格
    }];
}

按键缓存

如果实体有唯一标识符，可使用按键缓存API：

- (CGFloat)tableView:(UITableView *)tableView heightForRowAtIndexPath:(NSIndexPath *)indexPath {
    Entity *entity = self.entities[indexPath.row];
    return [tableView fd_heightForCellWithIdentifier:@"identifer" cacheByKey:entity.uid configuration:^(id cell) {
        // 配置单元格
    }];
}

缓存实现细节可查看Classes/UITableView+FDTemplateLayoutCell.m中的-fd_heightForCellWithIdentifier:cacheByIndexPath:configuration:和-fd_heightForCellWithIdentifier:cacheByKey:configuration:方法。

布局模式详解

两种布局模式

FDTemplateLayoutCell提供两种计算单元格高度的模式：

使用-systemLayoutSizeFittingSize:的自动布局模式
使用-sizeThatFits:的帧布局模式

库会根据内容视图是否设置自动布局约束自动选择合适的模式，如Classes/UITableView+FDTemplateLayoutCell.m中的-fd_systemFittingHeightForConfiguratedCell:方法实现。

强制使用帧布局模式

若要强制使用帧布局模式，需在配置块中设置fd_enforceFrameLayout属性：

cell.fd_enforceFrameLayout = YES;

使用帧布局模式时，必须在自定义单元格中重写-sizeThatFits:方法并返回内容视图的高度（不包括分隔线）：

- (CGSize)sizeThatFits:(CGSize)size {
    return CGSizeMake(size.width, A+B+C+D+E+....);
}

调试与问题排查

启用调试日志

调试日志有助于调试或检查FDTemplateLayoutCell扩展的运行情况，启用后会打印"计算中"、"预缓存"或"命中缓存"时的日志。默认禁用，通过NSLog输出。

self.tableView.fd_debugLogEnabled = YES;

日志输出示例：

** FDTemplateLayoutCell ** layout cell created - FDFeedCell
** FDTemplateLayoutCell ** calculate - [0:0] 233.5
** FDTemplateLayoutCell ** calculate - [0:1] 155.5
** FDTemplateLayoutCell ** hit cache - [0:3] 284
** FDTemplateLayoutCell ** hit cache - [0:4] 278.5

调试相关代码在Classes/UITableView+FDTemplateLayoutCellDebug.h中定义。

常见问题及解决方案

问题1：单元格高度计算为0

可能原因：

单元格不是自满足的，约束不完整
未正确注册单元格

解决方案：

检查并修复约束，确保单元格是自满足的
确保已通过以下方式之一注册了单元格重用标识符：
- 故事板中UITableView的原型单元格
- 使用-registerNib:forCellReuseIdentifier:
- 使用-registerClass:forCellReuseIdentifier:

问题2：滚动时性能不佳

解决方案：

使用缓存API（cacheByIndexPath或cacheByKey）
确保配置块中的操作最小化，仅足以计算单元格高度

问题3：iOS10及以上版本的约束冲突

解决方案：库已在Classes/UITableView+FDTemplateLayoutCell.m的-fd_systemFittingHeightForConfiguratedCell:方法中处理了iOS10+的约束问题，通过添加边缘约束避免冲突。

高级功能与扩展

页眉/页脚视图高度计算

除了单元格高度，还可计算页眉/页脚视图高度：

- (CGFloat)fd_heightForHeaderFooterViewWithIdentifier:(NSString *)identifier configuration:(void (^)(id headerFooterView))configuration;

相关实现见Classes/UITableView+FDTemplateLayoutCell.m中的UITableView (FDTemplateLayoutHeaderFooterView)分类。

访问内部模板单元格

可通过以下方法访问给定重用标识符的内部模板布局单元格：

- (__kindof UITableViewCell *)fd_templateCellForReuseIdentifier:(NSString *)identifier;

一般情况下不需要直接访问这些模板布局单元格，但在特殊调试场景下可能有用。

安装与版本历史

安装方法

版本历史

1.6: 修复iOS 10中的bug
1.4: 重构，添加"cacheByKey"模式，修复bug
1.3: 帧布局模式，处理单元格的辅助视图/类型
1.2: 预缓存和自动缓存失效
1.1: 高度缓存
1.0: 基本自动高度计算

总结

UITableView-FDTemplateLayoutCell通过提供简单易用的API，解决了UITableViewCell高度自动计算的问题。关键要点：

创建自满足的单元格是基础
根据场景选择合适的缓存策略
善用调试日志排查问题
确保正确注册单元格

通过本文介绍的方法，你应该能够避免大多数常见问题，实现高效的动态单元格高度计算。更多详情请参考README.md和源代码文件。

希望这篇指南对你有所帮助！如果觉得有用，请点赞、收藏并关注项目更新。如有其他问题，欢迎在项目仓库提交issue。

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考