UITableViewCell 注册探究

创建 UITableViewCell 的方式有两种：

- (UITableViewCell *)tableView:(UITableView *)tableView cellForRowAtIndexPath:(NSIndexPath *)indexPath {
    UITableViewCell *cell = [tableView dequeueReuseableCellWithIdentifier:@"cell"];
    if (!cell) {
        cell = [[UITableViewCell alloc] initWithStyle:UITableViewCellStyleDefault reuseIdentifier:@"cell"];
    }
    return cell;
}

// 注册
[tableView registerClass:[MyTableViewCell class] forCellReuseIdentifier:@"cell"];


- (UITableViewCell *)tableView:(UITableView *)tableView cellForRowAtIndexPath:(NSIndexPath *)indexPath {
    UITableViewCell *cell =[tableView dequeueReusableCellWithIdentifier:@"cell" forIndexPath:indexPath];
    return cell;
}

本文探讨为何注册的 Cell 在获取 cell 对象时需要传入 NSIndexPath。

猜测

先看看官方文档

- dequeueReusableCellWithIdentifier:forIndexPath:

Description
Returns a reusable table-view cell object for the specified reuse identifier and adds it to the table.

For performance reasons, a table view’��s data source should generally reuse UITableViewCell objects when it assigns cells to rows in its tableView:cellForRowAtIndexPath: method. A table view maintains a queue or list of UITableViewCell objects that the data source has marked for reuse. Call this method from your data source object when asked to provide a new cell for the table view. This method dequeues an existing cell if one is available, or creates a new one based on the class or nib file you previously registered, and adds it to the table.

Important
You must register a class or nib file using the registerNib:forCellReuseIdentifier: or registerClass:forCellReuseIdentifier: method before calling this method.
If you registered a class for the specified identifier and a new cell must be created, this method initializes the cell by calling its initWithStyle:reuseIdentifier: method. For nib-based cells, this method loads the cell object from the provided nib file. If an existing cell was available for reuse, this method calls the cell’s prepareForReuse method instead.

Parameters
identifier :A string identifying the cell object to be reused. This parameter must not be nil.
indexPath: The index path specifying the location of the cell. The data source receives this information when it is asked for the cell and should just pass it along. This method uses the index path to perform additional configuration based on the cell’s position in the table view.

Returns
A UITableViewCell object with the associated reuse identifier. This method always returns a valid cell.

SDKs iOS 6.0+, tvOS 9.0+
Declared In UIKit

官方文档对 indexPath 参数说明大致如下：

indexPath: index path 说明这个 cell 的位置。数据源会在被要求返回一个 cell 的方法里获取到这个 index path 对象，数据源应该将这个 index path 直接传入本方法中。本方法或根据传入的 index path 确定 cell 将会显示在 table view 中的位置，从而做一些基于这个位置的附加的配置操作

对于头文件，也有如下解释：

newer dequeue method guarantees a cell is returned and resized properly, assuming identifier is registered
返回之前会经过 resize

所以可以猜测：

1. 只是为了新增一个参数来区分新旧 API，从而区分是否要自动创建一个 cell 对象
   这个猜测有点强求，因为如果开发者希望自动创建时，会提前注册好 Class 或者 Nib，取得时候底层可以判断是否需要创建新的 cell；如果开发者不希望自动创建的话，就不会提前去注册，而方法返回一个 nil 出去，让数据源自己创建 cell 也很符合逻辑。所以 UIKit 是否需要一个新的参数来更改方法名，以达到区分 API 目的的猜想可能是假的。

2. 传入 indexPath 时，table view 会自动的根据 index path 判断 这个 cell 将会显示在什么位置，同时会根据数据源来获取这个位置对应的 frame 信息。然后将 cell 的 frame 设置好后，返回给数据源使用。

验证

编写一个简单的 UITableViewController ：

- (void)viewDidLoad {
    [super viewDidLoad];
    UITableView *tableView = [[UITableView alloc] initWithFrame:self.view.bounds style:UITableViewStylePlain];
    tableView.dataSource = self;
    tableView.delegate = self;
    [self.view addSubview:tableView];
    
    [tableView registerClass:[UITableViewCell class] forCellReuseIdentifier:@"cell"];
}

- (NSInteger)numberOfSectionsInTableView:(UITableView *)tableView {
    return 1;
}

- (NSInteger)tableView:(UITableView *)tableView numberOfRowsInSection:(NSInteger)section {
    return 10;
}

- (CGFloat)tableView:(UITableView *)tableView heightForRowAtIndexPath:(NSIndexPath *)indexPath {
    return 44;
}

- (UITableViewCell *)tableView:(UITableView *)tableView cellForRowAtIndexPath:(NSIndexPath *)indexPath {
    UITableViewCell *cell = [tableView dequeueReusableCellWithIdentifier:@"cell" forIndexPath:indexPath];
    return cell;
}

添加断点 -[UITableView dequeueReusableCellWithIdentifier:forIndexPath:]

image.png

跑起来后断在断点处：

image.png

可以发现这个方法调用了 _dequeueReusableCellWithIdentifier:forIndexPath:usingPresentationValues: 方法来获取 cell。

继续断点：

image.png image.png image.png image.png

大致可以了解到：

- (UITableViewCell *)_dequeueReusableCellWithIdentifier:(NSString *)identifier
    forIndexPath:(NSIndexPath *)indexPath
    usingPresentationValues:(id)values {
    
    // get cell with old method
    UITableViewCell *cell = [self dequeueReusableCellWithIdentifier:identifier];
    // ...
    
    // config with index path
    if ([self __shouldConfigureCellForDisplayDuringDequeueForIndexPath:indexPath]) {
        [self _configureCellForDisplay:cell forIndexPath:indexPath];
    }
}

所以可以看见，这个方法内部确实有用 index path 去做 config 的操作。具体 config 内容可以看 -[UITableView _configCellForDisplay:forIndexPath:]：

image.png

可以看见一部分 layout 的代码，所以 UITableView 在拿到 indexPath 后，对 cell 做了 resize 和 layout 的操作。

下面来验证这个 resize 操作。UITableView 拿到 indexPath 给 cell 设置 frame，肯定需要 cell 的高度，而 cell 高度可以被 UITableView 定制，所以肯定会去 UITableViewController 调用 - tableView:heightForRowAtIndexPath: 的方法来得到这个 row 高。

在 - (CGFloat)tableView:(UITableView *)tableView heightForRowAtIndexPath:(NSIndexPath *)indexPath] 方法打断点，观察调用栈：

image.png

果然在内部调用了获取行高的方法。所以猜想正确。

结论

数据源通过 -[UITableView dequeueReusableCellWithIdentifier:forIndexPath:] 传入的 index path，会被 UITableView 拿来取 cell 的渲染位置，然后赋值 size 并做 layout。

总的来说，知道这个结论对日常开发并没有什么多大的用处。。。。

但是知道了如何去分析系统行为，可以为以后的开发带来一点帮助。