TestsTested | ✗ |
LangLanguage | Obj-CObjective C |
License | MIT |
ReleasedLast Release | Dec 2014 |
Maintained by József Vesza.
A basic, reusable and expandable UITableViewDataSource
class, to take the clutter out of your UITableView
classes. To use it, you will also need a class that conforms to the JVRCellConfiguratorDelegate
, which will setup the individual cells, for the table view. For details about the usage, see the simple examples below, or refer to the example project.
Cell configurator classes aim to encapsulate the logic that previously belonged in the tableView:cellForRowAtIndexPath:
method found in the UITableViewDataSource
protocol. They can be used to return the reuse identifier for a cell according to the object it is supposed to show, and to customize its appearance or behavior.
// MyCellConfigurator.h
#import "JVRBaseTableViewDataSource.h"
@interface MyCellConfigurator : NSObject<JVRCellConfiguratorDelegate>
@end
// MyCellConfigurator.m
@implementation MyCellConfigurator
- (NSString *)fetchCellIdentifierForObject:(id)anObject
{
if ([anObject isKindOfClass:[MyClass class]])
{
return @"myCell";
}
return @"regularCell";
}
- (UITableViewCell *)configureCell:(MyCell *)cell usingObject:(MyClass *)object
{
cell.titleLabel.text = object.stringProperty;
return cell;
}
@end
By using JVRBaseTableViewDataSource
, many lines of boilerplate code can be omitted from UITableViewController
classes. Support for table view sections can be achieved by sublassing or editing this class, and implementing the numberOfSectionsInTableView:
method.
// MyTableViewController.m
#import "JVRBaseTableViewDataSource.h"
#import "MyCellConfigurator.h"
@interface MyTableViewController ()
@property (nonatomic, strong) JVRBaseTableViewDataSource *dataSource;
@end
@implementation MyTableViewController
- (void)viewDidLoad
{
[super viewDidLoad];
[self setupDataSource];
}
- (void)setupDataSource
{
self.dataSource = [JVRBaseTableViewDatasource datasourceForTableView:self.tableView
withItems:@[@"test", @"item"]
usingCellConfigurator:[[MyCellConfigurator alloc] init]];
}
@end
You can just copy the source files into your project, but the recommended way of using this class in your project is installation through CocoaPods with the following Podfile:
platform :ios, "7.1"
pod 'JVRBaseTableViewDataSource'