Advanced UICollectionView & UITableView

A framework for UICollectionView and UITableView that provides:

• Extended collection and table view diffable data sources with handlers for selecting, reordering, focusing and editing cells and additional functionality.
• Table view cell registration similar to UICollectionView.CellRegistration.
• Additional extensions for UICollectionView and UITableView.

UICollectionViewDiffableDataSource & TableViewDiffableDataSource

Handlers

There are handlers for selecting, reordering, focusing and editing cells.

Examples of some of the included handlers:

// Handler that gets called when the user did select an item.
diffableDataSource.selectionHandlers.didSelect ={ itemIdentifier in}
// Handler that gets called when an item/cell is about to be shown.
diffableDataSource.displayingHandlers.willDisplay ={ itemIdentifier, cell in}

TableViewDiffableDataSource provides handlers for reordering cells like the UICollectionViewDiffableDataSource reordering handlers that Apple provides:

// Allow every item to be reordered
tableViewDataSource.reorderingHandlers.canReorder ={ item inreturntrue}
// Update the backing store from the did reorder transaction.
tableViewDataSource.reorderingHandlers.didReorder ={[weak self] transaction, _ inguardlet self =selfelse{return}iflet updatedCurrentItems =self.currentItems.applying(transaction.difference){self.currentItems = updatedCurrentItems
}}

Empty datasource view

emptyView displays the provided view when the datasource doesn't contain any items:

diffableDataSource.emptyView = myEmptyView

Alternatively you can use emptyContentConfiguration and provide an UIContentConfiguration:

letloadingConfiguration=UIContentUnavailableConfiguration.loading()
diffableDataSource.emptyContentConfiguration = loadingConfiguration

UITableView Cell Registration

A registration for the table view’s cells similar to UICollectionView.CellRegistration.

Use a cell registration to register table cell views with your table view and configure each cell for display.

The following example creates a cell registration for cells of type UITableViewCell and string items. Each cells textfield displays its item string.

letcellRegistration=UITableView.CellRegistration<UITableViewCell,String>{ cell, indexPath, string invarcontentConfiguration= cell.defaultContentConfiguration()
contentConfiguration.text = string
contentConfiguration.textProperties.color =.lightGray
cell.contentConfiguration = contentConfiguration
}

After you create a cell registration, you pass it in to dequeueConfiguredReusableCell(using:for:item:), which you call from your data source’s cell provider.

dataSource =UITableViewDiffableDataSource<Section,String>(tableView: tableView){
tableView, indexPath, item inreturn tableView.dequeueConfiguredReusableCell(using: cellRegistration, for: indexPath, item: item)}

Alternatively you can use the UICollectionViewDiffableDataSource and UITableViewDiffableDataSource initializers:

letdataSource=UITableViewDiffableDataSource(tableView: myTableView, cellRegistration: cellRegistration)}

UITableView Section View Registration

A registration for the table view’s header/footer section views.

The following example creates a section view registration for views of type UITableViewHeaderFooterView for sections with strings. Each section header views default content configuration text displays its section string.

letsectionViewRegistration=UITableView.SectionViewRegistration<UITableViewHeaderFooterView,String>{
sectionView, indexPath, string invarconfiguration= sectionView.defaultContentConfiguration()
configuration.text = string
sectionView.contentConfiguration = configuration
}

After you create a section view registration, you pass it in to dequeueConfiguredReusableSectionView(using:section:), which you call from your data source’s section header view provider.

dataSource.headerViewProvider ={ tableView, section inreturn tableView.dequeueConfiguredReusableSectionView(using: sectionViewRegistration, section: section)}

Alternatively you can also applyHeaderViewRegistration() and `applyFooterViewRegistration()``:

dataSource.applyHeaderViewRegistration(sectionViewRegistration)

Diffable DataSource Snapshot Apply Options

Options for applying snapshots to a diffable datasource:

// Applies the snapshot animated with default animation duration.
dataSource.apply(mySnapshot,.animated)
// Applies the snapshot animated with the specified animation duration.
dataSource.apply(mySnapshot,.animated(duration:2.0))
// Applies the snapshot non animated.
dataSource.apply(mySnapshot,.withoutAnimation)
// Applies the snapshot using reload data.
dataSource.apply(mySnapshot,.usingReloadData)