UITableViewDataSource-RACExtensions

Usage

To run the example projects:

0. hub clone michaelavila/UITableViewDataSource-RACExtensions, if you haven't already
1. cd UITableViewDataSource-RACExtensions
2. either cd Examples/Basic or cd Examples/Custom
3. Basic: Uses basic UITableCell + NSString
4. Protocol: Uses RACTableCell protocol prepareToAppear
5. bundle install, if you don't have bundler than first run gem install bundler
6. bundle exec pod install
7. open Example.xcworkspace

The primary difference between the Basic and Protocol examples is the use of the RACTableViewCell protocol to render objects other than strings.

Both examples are very short and should be easy to digest. In particular, pay attention to the EAppDelegate.m files in both projects. In the Protocol project, it is important to notice both the additional ETableViewCell class as well as setting that class on the prototype cell in Main.storyboard. Pay attention to both.

UITableViewController+RACExtensions

If you #import <UITableViewDataSource-RACExtensions/UITableViewController+RACTableViewDataSource.h> then all UITableViewControllers will have a rac_dataSource method. This is what the signature for dataSource looks like:

- (id<UITableViewDataSource>)rac_dataSource:(RACSignal *)signal reuseIdentifier:(NSString *)reuseIdentifier;

The events that signal emits will be bound as the data for the UITableView. The reuseIdentifier is specified on the UITableViewCell that you want to create new cell views out of.

Here is both a basic usage as well as an example using more complex data. Basic first:

#import "EAppDelegate.h"
#import <UITableViewDataSource-RACExtensions/UITableViewController+RACTableViewDataSource.h>

@implementation EAppDelegate
{
    id<UITableViewDataSource> groceryList;
}

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
{
    groceryList = [(UITableViewController *)self.window.rootViewController
        rac_dataSource:[RACSignal return:@[@"Bananas", @"Beer"]]
        reuseIdentifier:@"groceryListItemCell"];

    return YES;
}

@end

And here is an example with less basic data:

#import "EAppDelegate.h"
#import <UITableViewDataSource-RACExtensions/UITableViewController+RACTableViewDataSource.h>

@implementation EAppDelegate
{
    id<UITableViewDataSource> groceryList;
}

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
{
    groceryList = [(UITableViewController *)self.window.rootViewController
        rac_dataSource:[RACSignal return:@[
            @{@"name": @"Oranges", @"quantity": @"2 dozen"},
            @{@"name": @"Beer", @"quantity": @"6 pack"}
        ]]
        reuseIdentifier:@"groceryListItemCell"];

    return YES;
}

@end

And since the dataSource is a signal you can swap it out for more complex signals that actually make network requests (or not).

RACTableViewCell

This protocol defines one simple method:

- (void)prepareToAppear:(NSObject *)data;

This is the method that the RACTableViewDataSource uses to give each cell its data.

For an example implementation checkout the ETableViewCell ETableViewCell.h and ETableViewCell.m from the protocol example which renders data more complicated than an NSString.

Installation

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

pod "UITableViewDataSource-RACExtensions"

Author

Michael Avila

Acknowledgments

Colen Eberhardt's notes here were an influence.

License

UITableViewDataSource-RACExtensions is available under the MIT license. See the LICENSE file for more info.