forkingdog /UITableView-FDTemplateLayoutCell

Template auto layout cell for automatically UITableViewCell height calculating

★ 9,852⑂ 1,982👁 324⑃ 39● 380▤ 0
Objective-CMITCreated 2015-04-16
+0
日增长
9,852
stars
1,982
forks
324
watchers
39
prs
380
issues
0
releases

README

UITableView-FDTemplateLayoutCell


 Overview
Template auto layout cell for automatically UITableViewCell height calculating.

!Demo Overview

 Basic usage

If you have a self-satisfied cell, then all you have to do is: 

 objc
import "UITableView+FDTemplateLayoutCell.h"

- (CGFloat)tableView:(UITableView )tableView heightForRowAtIndexPath:(NSIndexPath )indexPath
{
    return [tableView fd_heightForCellWithIdentifier:@"reuse identifer" configuration:^(id cell) {
        // Configure this cell with data, same as what you've done in "-tableView:cellForRowAtIndexPath:"
        // Like:
        //    cell.entity = self.feedEntities[indexPath.row];
    }];
}


 Height Caching API

Since iOS8, -tableView:heightForRowAtIndexPath: will be called more times than we expect, we can feel these extra calculations when scrolling. So we provide another API with cache by index path:   

 objc
- (CGFloat)tableView:(UITableView )tableView heightForRowAtIndexPath:(NSIndexPath )indexPath {
    return [tableView fd_heightForCellWithIdentifier:@"identifer" cacheByIndexPath:indexPath configuration:^(id cell) {
        // configurations
    }];
}


Or, if your entity has an unique identifier, use cache by key API:

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


 Frame layout mode

FDTemplateLayoutCell offers 2 modes for asking cell's height.  

1. Auto layout mode using "-systemLayoutSizeFittingSize:"  
2. Frame layout mode using "-sizeThatFits:"  

Generally, no need to care about modes, it will automatically choose a proper mode by whether you have set auto layout constrants on cell's content view. If you want to enforce frame layout mode, enable this property in your cell's configuration block:  

 objc
cell.fd_enforceFrameLayout = YES;

And if you're using frame layout mode, you must override -sizeThatFits: in your customized cell and return content view's height (separator excluded)


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


 Debug log

Debug log helps to debug or inspect what is this "FDTemplateLayoutCell" extention doing, turning on to print logs when "calculating", "precaching" or "hitting cache".Default to "NO", log by "NSLog".

 objc
self.tableView.fd_debugLogEnabled = YES;


It will print like this:  

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

Top issues

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON