Alister

Overview

Alister allows to manage the content of any UITableView or UICollectionView. The general idea is provide a layer that synchronizes data with the cell appearance for such operations like adding, moving, deleting and reordering. Alister automatically handle UITableView and UICollectionView data source and delegates protocols and you can override them by subclassing from base controllers.

Features

• Works with UITableView and UICollectionView
• Supports all operations for sections and rows such as Insert, Delete, Move, Reload
• Supports UISearchBar and provide search predicate
• Supports custom header and footer views
• Provides keyboard handling
• Provides bottom sticked footer as part of ANTableView

Usage

Initialize storage and list controller

Use ANTableController and ANCollectionController for UITableView and UICollectionView respectively.

self.storage = [ANStorage new];
self.tableController = [ANTableController controllerWithTableView:self.tableView];
[self.tableController attachStorage:self.storage];
self.collectionController = [ANCollectionController controllerWithCollectionView:self.collectionView];
[self.collectionController attachStorage:self.storage];

Register cell, header and footer views for models

You can register any views for any model classes.

[self.controller configureCellsWithBlock:^(id<ANListControllerReusableInterface> configurator) {

[configurator registerCellClass:[ANBaseTableViewCell class]
forModelClass:[ANBaseTableViewCellViewModel class]];

[configurator registerFooterClass:[ANBaseTableFooterView class]
forModelClass:[NSString class]];

[configurator registerHeaderClass:[ANBaseTableHeaderView class]
forModelClass:[NSString class]];
}];

Add models to ANStorage

NSArray* models = [self generateModels];
[self.storage updateWithoutAnimationChangeBlock:^(id<ANStorageUpdatableInterface> storageController) {
[storageController addItems:models]; // items will be added to a first section by default
[storageController addItems:models toSection:10];
[storageController addItem:@"Title" atIndexPath:indexPath];
// Supplementary models
[storageController updateSectionHeaderModel:headerTitle forSectionIndex:0];
[storageController updateSectionFooterModel:footerTitle forSectionIndex:0];
}];

And that`s all!

Here is an inline . {:height="50px" width="90px"}

Changing cells order

Alister will change order of cells and models in storage automatically. Or you can change it manually:

[self.storage updateWithAnimationChangeBlock:^(id<ANStorageUpdatableInterface> storageController) {
[storageController moveItemFromIndexPath:fromIndexPath toIndexPath:toIndexPath];
}];

Models search with UISearchBar

Alister provides an ablility to search in storage. To use it, search bar and search predicate block must be set:

[self.controller attachSearchBar:self.searchBar];
[self.controller updateSearchingPredicateBlock:[self predicateBlock]];

Where search predicate block is:

- (ANListControllerSearchPredicateBlock)predicateBlock
{
return ^NSPredicate* (NSString* searchString, NSInteger scope) {

NSPredicate* predicate = nil;
if (searchString)
{
predicate = [NSPredicate predicateWithFormat:@"self BEGINSWITH[cd] %@", searchString];
}

return predicate;
};
}

Item selection

Provide configureItemSelectionBlock: block for handling default cells selection.

[self.controller configureItemSelectionBlock:^(id model, NSIndexPath *indexPath) {
    //Handle selection
}];

Custom header and footer views

Provide custom header and footer for list views.

[self.storage updateWithAnimationChangeBlock:^(id<ANStorageUpdatableInterface> storageController) {
    [storageController updateSectionHeaderModel:headerModel forSectionIndex:0];
    [storageController updateSectionFooterModel:footerModel forSectionIndex:0];
}];

Table sticked footer

ANTableView provides an ability to set custom sticked footer.

[self.tableView addStickyFooter:self.footerView withFixedHeight:100];
[self.tableView updateStickerHeight:200];

Demo

See projects example or use it by web (Appetize.io link) To run the example project, clone the repo or download, and run pod install from the Example directory first.

Requirements

Xcode 7.2 or higher iOS 9 or higher

Installation

Alister is available through CocoaPods. To install it, simply add the following line to your Podfile:

pod "Alister"

Changelog

0.2

renamed methods in ANStorage:

• setHeaderModel: sectionIndex:
• setFooterModel: sectionIndex:

to update ... model

Author

Oksana Kovalchuk, [email protected]

License

Alister is available under the MIT license. See the LICENSE file for more info.