EPSReactiveList provides subclasses of UITableViewController and UICollectionViewController that automatically populate a table/collection view, and animates the insertion and deletion of rows/items by observing changes to an array of model objects. It uses ReactiveCocoa, and is designed to be used with the MVVM pattern.
EPSReactiveList replaces EPSReactiveTableViewController and EPSReactiveCollectionViewController.
Subclass either EPSReactiveTableViewController or EPSReactiveCollectionViewController, and write an init method which calls setBindingToKeyPath:onObject: to set up the binding. The value at the key path must always be an NSArray containing objects that implement -isEqual: and -hash. No object should appear in the array more than once. In the init method, register a cell class for use with the class of object that will be contained in the observed array. (The cell class must conform to <EPSReactiveListCell>.)
- (id)init {
self = [super initWithStyle:UITableViewStylePlain];
if (self == nil) return nil;
_viewModel = [EPSExampleViewModel new];
[self setBindingToKeyPath:@"sortedNotes" onObject:_viewModel];
[self registerCellClass:[EPSNoteCell class] forObjectsWithClass:[EPSNote class]];
...
return self;
}To respond to taps on cells, override either -tableView:didSelectRowForObject:atIndexPath: or -collectionView:didSelectItemForObject:atIndexPath:, depending on whether you have subclassed EPSReactiveTableViewController or EPSReactiveCollectionViewController.
- (void)tableView:(UITableView *)tableView didSelectRowForObject:(id)object atIndexPath:(NSIndexPath *)indexPath {
// Do something with `object`
}You don’t need to write any datasource methods.
For more complete examples of how to use EPSReactiveTableViewController and EPSReactiveCollectionViewController, see the example project.
To run the example project; clone the repo, and run pod install from the Project directory first.
EPSReactiveTableViewController requires ReactiveCocoa 2.3 or higher.
EPSReactiveList is available through CocoaPods—to install it simply add the following line to your Podfile:
pod "EPSReactiveList"Alternatively, include the files in the Classes directory in your project, and install ReactiveCocoa 2.3 by following their installation instructions.
EPSReactiveList is available under the MIT license. See the LICENSE file for more info.