UITableView(QMUICellHeightKeyCache)

@interface UITableView (QMUICellHeightKeyCache)

自动缓存 self-sizing cell 的高度，避免重复计算。使用方法：

  1. 将 tableView.qmui_cacheCellHeightByKeyAutomatically = YES
  2. 实现 tableView 的 delegate 方法 qmui_tableView:cacheKeyForRowAtIndexPath: 返回一个 key。建议 key 由所有可能影响高度的字段拼起来，这样当数据发生变化时不需要手动更新缓存。

Note

注意这里的高度缓存仅适合于使用 self-sizing 机制的 tableView（也即 tableView.rowHeight = UITableViewAutomaticDimension），QMUICellHeightKeyCache 会自动在 willDisplayCell 里将 cell 的当前高度缓存起来，然后在 heightForRow 里从缓存中读取高度后使用。

Note

如果 tableView 开启了 qmui_cacheCellHeightByKeyAutomatically 并且 tableView.delegate 实现了 tableView:heightForRowAtIndexPath:，如果返回值 >= 0则使用这个返回值当成最终的高度，如果 < 0 则交给 QMUICellHeightKeyCache 自己处理。

Note

如果 tableView 开启了 qmui_cacheCellHeightByKeyAutomatically 并且 tableView.delegate 实现了 tableView:estimatedHeightForRowAtIndexPath:，则当该 indexPath 所在的 cell 的高度已经被计算过的情况下，业务自己的 tableView:estimatedHeightForRowAtIndexPath: 不会被调用，只有当高度缓存里找不到该 indexPath 对应的 key 的缓存时，才会调用业务的这个方法。

Note

在 UITableView 的宽度和 contentInset、safeAreaInsets 发生变化时（例如横竖屏旋转、iPad 分屏），高度缓存会自动刷新，所以无需为这种情况做保护。

  • 控制是否要自动缓存 cell 的高度，默认为 NO

    Declaration

    Objective-C

    @property (nonatomic) BOOL qmui_cacheCellHeightByKeyAutomatically;

    Swift

    var qmui_cacheCellHeightByKeyAutomatically: Bool { get set }

  • 获取当前的缓存容器。tableView 的宽度和 contentInset 发生变化时，这个数组也会跟着变，但当 tableView 宽度小于 0 时会返回 nil。

    Declaration

    Objective-C

    @property (nonatomic, weak, readonly, nullable) QMUICellHeightKeyCache *qmui_currentCellHeightKeyCache;

    Swift

    weak var qmui_currentCellHeightKeyCache: QMUICellHeightKeyCache? { get }

  • 搭配 QMUICellHeightKeyCache，清除某个指定 key 的缓存，注意不要直接调用 self.qmui_currentCellHeightKeyCache.invalidateHeightForKey，因为一个 UITableView 里会包含多个 QMUICellHeightKeyCache，那样写只能刷新当前的 QMUICellHeightKeyCache，其他宽度下的 QMUICellHeightKeyCache 无法刷新。

    Declaration

    Objective-C

    - (void)qmui_invalidateCellHeightCachedForKey:(nonnull id<NSCopying>)key;

    Swift

    func qmui_invalidateCellHeightCached(forKey key: NSCopying)

  • 搭配 QMUICellHeightKeyCache，清除所有状态下的缓存

    Declaration

    Objective-C

    - (void)qmui_invalidateAllCellHeightKeyCache;

    Swift

    func qmui_invalidateAllCellHeightKeyCache()