FDUITableView+FDTemplateLayoutCe

2019-01-06  本文已影响0人  532321

先从我们使用这个框架最主要调用的函数来看:
- (CGFloat)fd_heightForCellWithIdentifier:(NSString *)identifier cacheByIndexPath:(NSIndexPath *)indexPath configuration:(void (^)(id cell))configuration
里面的代码是这样的:

    if (!identifier || !indexPath) {
        return 0;
    }
    
    // Hit cache
    if ([self.fd_indexPathHeightCache existsHeightAtIndexPath:indexPath]) {
        [self fd_debugLog:[NSString stringWithFormat:@"hit cache by index path[%@:%@] - %@", @(indexPath.section), @(indexPath.row), @([self.fd_indexPathHeightCache heightForIndexPath:indexPath])]];
        return [self.fd_indexPathHeightCache heightForIndexPath:indexPath];
    }
    
    CGFloat height = [self fd_heightForCellWithIdentifier:identifier configuration:configuration];
    [self.fd_indexPathHeightCache cacheHeight:height byIndexPath:indexPath];
    [self fd_debugLog:[NSString stringWithFormat: @"cached by index path[%@:%@] - %@", @(indexPath.section), @(indexPath.row), @(height)]];
    
    return height;
}

大体逻辑就是:
1、如果没有传入identifier 或者 iddexpath 其中一个就返回高度0
2、 在高度缓存中如果有当前indexPah的高度缓存就直接返回高度,如果打开了日志输出会打印日志
3、如果没有缓存,计算高度,缓存高度,最后返回高度

细节分析:
判断是否有缓存:

[self.fd_indexPathHeightCache existsHeightAtIndexPath:indexPath]
fd_indexPathHeightCache用来管理缓存的一个类,高度存储在了数组中。数组的结构根据tableview的indexPath的section和row来决定。比如:
@[@[@-1,@-1,@-1].mutableCopy,@[@-1].mutableCopy,@[@-1].mutableCopy] .mutableCopy
有3个section,第一个里面3个cell,第二和第三个里面1个cell,高度都是-1
取值前会判断是否创建数组,如果没有就先创建数组,高度都先默认给-1。
通过 数组[indexPath.section][indexPath.row],获取高度,如果是-1说明没有缓存

计算高度

CGFloat height = [self fd_heightForCellWithIdentifier:identifier configuration:configuration];
里面的代码:

    if (!identifier) {
        return 0;
    }
    
    UITableViewCell *templateLayoutCell = [self fd_templateCellForReuseIdentifier:identifier];
    
    // Manually calls to ensure consistent behavior with actual cells. (that are displayed on screen)
    [templateLayoutCell prepareForReuse];
    
    // Customize and provide content for our template cell.
    if (configuration) {
        configuration(templateLayoutCell);
    }
    
    return [self fd_systemFittingHeightForConfiguratedCell:templateLayoutCell];
} 

1、获取cell,通过[self dequeueReusableCellWithIdentifier:identifier]来获取,然后存到一个字典中,下次直接在字典中取值,用runtime的set/get来添加一个属性templateCellsByIdentifiers获取字典中的cell
[templateLayoutCell prepareForReuse];
系统准备复用会自动调用的方法,这里主动调用了,作者也给了说明:主动调用时为了和实际上的cell行为保持一致(和那些显示在屏幕上的cell)
2、通过block回调返回cell,也就是我们看的第一个函数中的cell回调
3、计算高度
先根据设置CellAccessory的类型计算cell的宽度,给cell的contentView添加宽度约束
// [bug fix] after iOS 10.3, Auto Layout engine will add an additional 0 width constraint onto cell's content view, to avoid that, we add constraints to content view's left, right, top and bottom.
作者提到:在iOS 10.3之后,Auto Layout会自动给contentview加上宽度为0的约束,为了避免这种情况我们给加上下左右的约束

            // To avoid confilicts, make width constraint softer than required (1000)
            widthFenceConstraint.priority = UILayoutPriorityRequired - 1;
            
            // Build edge constraints
            NSLayoutConstraint *leftConstraint = [NSLayoutConstraint constraintWithItem:cell.contentView attribute:NSLayoutAttributeLeft relatedBy:NSLayoutRelationEqual toItem:cell attribute:NSLayoutAttributeLeft multiplier:1.0 constant:0];
            NSLayoutConstraint *rightConstraint = [NSLayoutConstraint constraintWithItem:cell.contentView attribute:NSLayoutAttributeRight relatedBy:NSLayoutRelationEqual toItem:cell attribute:NSLayoutAttributeRight multiplier:1.0 constant:0];
            NSLayoutConstraint *topConstraint = [NSLayoutConstraint constraintWithItem:cell.contentView attribute:NSLayoutAttributeTop relatedBy:NSLayoutRelationEqual toItem:cell attribute:NSLayoutAttributeTop multiplier:1.0 constant:0];
            NSLayoutConstraint *bottomConstraint = [NSLayoutConstraint constraintWithItem:cell.contentView attribute:NSLayoutAttributeBottom relatedBy:NSLayoutRelationEqual toItem:cell attribute:NSLayoutAttributeBottom multiplier:1.0 constant:0];
            edgeConstraints = @[leftConstraint, rightConstraint, topConstraint, bottomConstraint];
            [cell addConstraints:edgeConstraints];
        }

然后作者判断如果系统在10.2之后就用NSLayoutConstraint给contentView加上了相对于cell上下左右都为0的约束
高度计算也很简单:

fittingHeight = [cell.contentView systemLayoutSizeFittingSize:UILayoutFittingCompressedSize].height;

通过系统的方法 systemLayoutSizeFittingSize来获取到高度
计算结束之后,作者又移除了刚刚添加的宽度和上下左右的约束

if (fittingHeight == 0) {
#if DEBUG
        // Warn if using AutoLayout but get zero height.
        if (cell.contentView.constraints.count > 0) {
            if (!objc_getAssociatedObject(self, _cmd)) {
                NSLog(@"[FDTemplateLayoutCell] Warning once only: Cannot get a proper cell height (now 0) from '- systemFittingSize:'(AutoLayout). You should check how constraints are built in cell, making it into 'self-sizing' cell.");
                objc_setAssociatedObject(self, _cmd, @YES, OBJC_ASSOCIATION_RETAIN_NONATOMIC);
            }
        }
#endif
        // Try '- sizeThatFits:' for frame layout.
        // Note: fitting height should not include separator view.
        fittingHeight = [cell sizeThatFits:CGSizeMake(contentViewWidth, 0)].height;
        
        [self fd_debugLog:[NSString stringWithFormat:@"calculate using sizeThatFits - %@", @(fittingHeight)]];
    }

如果计算结果为0,如果contentview的约束的个数大于0,就是打印警告:无法通过systemFittingSize来获取到cell的高度,请检查cell中的约束,使其成为“self-sizing”cell(可以通过约束自动计算高度的cell)。

 // Still zero height after all above.
    if (fittingHeight == 0) {
        // Use default row height.
        fittingHeight = 44;
    }
    
    // Add 1px extra space for separator line if needed, simulating default UITableViewCell.
    if (self.separatorStyle != UITableViewCellSeparatorStyleNone) {
        fittingHeight += 1.0 / [UIScreen mainScreen].scale;
    }

高度一些细节添加,这两句就不说了
4、缓存高度
之前也说了,高度存在数组之中,现在做的就是根据indexPath给数组中对应的-1个高度替换成现在计算的结果

补充

大体的代码逻辑就是这样了,当然还有一写细节的处理,比如reload会重新生成新的数组结构。作者通过runtime的method_exchangeImplementations方法交换了remove、insert、delete、move、reload这些方法来实时修改数组,保证了数组结构的正确性。

总结

整个框架的难道其实并不高,并没有传说中用到runloop根据空闲时间存储高度。但是思维很严谨,细节很完善。用到了很多runtime的知识,值得学习。

上一篇下一篇

猜你喜欢

热点阅读