RETableViewManager allows to manage the content of any UITableView with ease, both forms and lists. RETableViewManager is built on top of reusable cells technique and provides APIs for mapping any object class to any custom cell subclass.

The general idea is to allow developers to use their own UITableView and UITableViewController instances, providing a layer that synchronizes data with cell appereance. It fully implements UITableViewDelegate and UITableViewDataSource protocols so you don't have to.

It is still in the early stages of development and it's highly not recommended to use it in production apps.

Quick Example

Get your UITableView up and running in couple minutes:

- (void)viewDidLoad
{
    [super viewDidLoad];

    // Create the manager and assign a UITableView
    //
    _manager = [[RETableViewManager alloc] initWithTableView:self.tableView];

    // Add a section
    //
    RETableViewSection *section = [RETableViewSection sectionWithHeaderTitle:@"Test"];
    [manager addSection:section];

    // Add a string
    //
    [section addItem:@"Just a simple NSString"];

    // Add a basic cell with disclosure indicator
    //
    [section addItem:[RETableViewItem itemWithTitle:"String cell" accessoryType:UITableViewCellAccessoryDisclosureIndicator selectionHandler:^(RETableViewItem *item) {
        NSLog(@"Test: %@", item);
    }]];

    // Custom items / cells
    //
    _manager[@"CustomItem"] = @"CustomCell";

    [section addItem:[[CustomItem alloc] init]];
}

RETableViewManager comes pre-packaged with extensible and ready-to-use components:

Text

Bool
Number
Float
Date/Time
Long Text
Radio option selector
Multiple option selector
Credit card and expiration date

Also, RETableViewManager provides APIs for super easy cell styling.

Requirements

Xcode 4.6 or higher
Apple LLVM compiler
iOS 6.0 or higher
ARC

Demo

Build and run the RETableViewManagerExample project in Xcode to see RETableViewManager in action.

Installation

CocoaPods

The recommended approach for installating RETableViewManager is via the CocoaPods package manager, as it provides flexible dependency management and dead simple installation. For best results, it is recommended that you install via CocoaPods >= 0.15.2 using Git >= 1.8.0 installed via Homebrew.

Install CocoaPods if not already available:

$ [sudo] gem install cocoapods
$ pod setup

Change to the directory of your Xcode project:

$ cd /path/to/MyProject
$ touch Podfile
$ edit Podfile

Edit your Podfile and add RETableViewManager:

platform :ios, '6.0'
pod 'RETableViewManager', '~> 0.1.0'

Install into your Xcode project:

$ pod install

Open your project in Xcode from the .xcworkspace file (not the usual project file)

$ open MyProject.xcworkspace

Please note that if your installation fails, it may be because you are installing with a version of Git lower than CocoaPods is expecting. Please ensure that you are running Git >= 1.8.0 by executing git --version. You can get a full picture of the installation details by executing pod install --verbose.

API Quickstart

Key Classes
RETableViewManager	Main manager class. Each manager has multiple `RETableViewSection` sections.
RETableViewSection	Represents sections in RETableViewManager, each section has multiple `RETableViewItem`.
RETableViewItem	RETableViewItem is the root class of most `RETableViewManager` item hierarchies. Through `RETableViewItem`, items inherit a basic interface that communicates with `RETableViewCell` and `RETableViewManager`.
RETableViewCell	The `RETableViewCell` class defines the attributes and behavior of the cells that appear in `UITableView` objects. You should subclass `RETableViewCell` to obtain cell characteristics and behavior specific to your application's needs. By default, `RETableViewCell` is being mapped with `RETableViewItem`.
Styling
RETableViewCellStyle	Provides style for `RETableViewCell` subclasses. You can define such properties as `textFieldFont`, `cellHeight`, `backgroundImage` and more.
Helper Controllers
RETableViewOptionsController	Performs selection based on user input and provides result on completion. Should be used with RERadioItem.

RETableViewManager includes a number of built-in items and cells that were mapped with each other so you don't have to.

Built-in Items and Cells
Item Class	Cell Class	Description
RETextItem	RETableViewTextCell	Provides convenience for user text input. You can set a bunch of properties through `RETextItem` that you would normally find in `UITextField`.
RELongTextItem	RETableViewLongTextCell	Provides convenience for multiline user text input. You can set a bunch of properties through `RELongTextItem` that you would normally find in `UITextView`.
RENumberItem	RETableViewNumberCell	Provides convenience for user number input using REFormattedNumberField.
REBoolItem	RETableViewBoolCell	Provides convenience for user boolean input using `UISwitch`.
RERadioItem	RETableViewCell	Provides convenience for selecting a single option using `RETableViewOptionsController`.
REMultipleChoiceItem	RETableViewCell	Provides convenience for selecting multiple options using `RETableViewOptionsController`.
REFloatItem	RETableViewFloatCell	Provides convenience for adjusting float values from 0.0 to 1.0.
REDateTimeItem	RETableViewDateTimeCell	Provides convenience for adjusting NSDate object.
RECreditCardItem	RETableViewCreditCardCell	Provides convenience for user credit card input. Allows to enter credit card number, expiration date and security code all in one table cell.

Examples

Creating Sections Example

Section without a title:

RETableViewSection *section = [RETableViewSection section];
[_tableViewManager addSection:section];

Section with a title:

RETableViewSection *section = [RETableViewSection sectionWithHeaderTitle:@"Header"];
[_tableViewManager addSection:section];

Section with a title and a footer:

RETableViewSection *section = [RETableViewSection sectionWithHeaderTitle:@"Header" footerTitle:@"Footer"];
[_tableViewManager addSection:section];

Section with a custom title view:

RETableViewSection *section = [RETableViewSection sectionWithHeaderView:myCustomSectionHeaderView];
[_tableViewManager addSection:section];

Item to Cell Mapping Example

It's super easy to create custom mappings, the concept is similiar to UICollectionView. For example, this how all NSString objects are being mapped to RETableViewCell:

_tableViewManager[@"NSString"] = @"RETableViewCell";

If you take a look at RETableViewManager Source Code you may find out how default mapping is performed:

- (void)registerDefaultClasses
{
    self[@"__NSCFConstantString"] = @"RETableViewCell";
    self[@"__NSCFString"] = @"RETableViewCell";
    self[@"NSString"] = @"RETableViewCell";
    self[@"RETableViewItem"] = @"RETableViewCell";
    self[@"RERadioItem"] = @"RETableViewOptionCell";
    self[@"REBoolItem"] = @"RETableViewBoolCell";
    self[@"RETextItem"] = @"RETableViewTextCell";
    self[@"RELongTextItem"] = @"RETableViewLongTextCell";
    self[@"RENumberItem"] = @"RETableViewNumberCell";
    self[@"REFloatItem"] = @"RETableViewFloatCell";
    self[@"REDateTimeItem"] = @"RETableViewDateTimeCell";
    self[@"RECreditCardItem"] = @"RETableViewCreditCardCell";
    self[@"REMultipleChoiceItem"] = @"RETableViewOptionCell";
}

Text (UITextField) and Number (REFormattedNumberField) Item Example

// Create the manager and assign it to be the delegate and datasource of your UITableView
//
_tableViewManager = [[RETableViewManager alloc] init];
self.tableView.delegate = _tableViewManager;
self.tableView.dataSource = _tableViewManager;

// Add a section
//
RETableViewSection *section = [[RETableViewSection alloc] initWithHeaderTitle:@"Test"];
[_tableViewManager addSection:section];

_textItem = [RETextItem itemWithTitle:@"Enter text" value:@""];
[section addItem:_textItem];

_numberItem = [RENumberItem itemWithTitle:@"Enter text" value:@"" placeholder:@"(123) 456-7890" format:@"(XXX) XXX-XXXX"];
[section addItem:_numberItem];

You can read _textItem.value and _numberItem.value later whenever you need them.

Bool Item (UISwitch) Example

// Create the manager and assign it to be the delegate and datasource of your UITableView
//
_tableViewManager = [[RETableViewManager alloc] init];
self.tableView.delegate = _tableViewManager;
self.tableView.dataSource = _tableViewManager;

// Add a section
//
RETableViewSection *section = [[RETableViewSection alloc] initWithHeaderTitle:@"Test"];
[_tableViewManager addSection:section];

// Add a bool value cell (using UISwitch)
//
[section addItem:[REBoolItem itemWithTitle:@"Switch test" value:YES switchValueChangeHandler:^(REBoolItem *item) {
    NSLog(@"Value: %i", item.value);
}]];

Radio (RETableViewOptionsController) Item Example

// Create the manager and assign it to be the delegate and datasource of your UITableView
//
_tableViewManager = [[RETableViewManager alloc] initWithTableView:self.tableView];

// Add a section
//
RETableViewSection *section = [[RETableViewSection alloc] initWithHeaderTitle:@"Test"];
[_tableViewManager addSection:section];

// Add radio cell (options)
//
__typeof (&*self) __weak weakSelf = self;
RERadioItem *optionItem = [RERadioItem itemWithTitle:@"Radio" value:@"Option 4" selectionHandler:^(RERadioItem *item) {
  [weakSelf.tableView deselectRowAtIndexPath:item.indexPath animated:YES];

  // Generate sample options
  //
  NSMutableArray *options = [[NSMutableArray alloc] init];
  for (NSInteger i = 1; i < 40; i++)
      [options addObject:[NSString stringWithFormat:@"Option %i", i]];

  // Present options controller
  //
  RETableViewOptionsController *optionsController = [[RETableViewOptionsController alloc] initWithItem:item options:options completionHandler:^(RETableViewItem *selectedItem) {
      item.value = selectedItem.title;
      [weakSelf.tableView reloadRowsAtIndexPaths:@[item.indexPath] withRowAnimation:UITableViewRowAnimationNone];
  }];
  [weakSelf.navigationController pushViewController:optionsController animated:YES];
}];
[section addItem:optionItem];

Float Item (UISlider) Example

// Create the manager and assign it to be the delegate and datasource of your UITableView
//
_tableViewManager = [[RETableViewManager alloc] init];
self.tableView.delegate = _tableViewManager;
self.tableView.dataSource = _tableViewManager;

// Add a section
//
RETableViewSection *section = [[RETableViewSection alloc] initWithHeaderTitle:@"Test"];
[_tableViewManager addSection:section];

// Add a float item
//
[section addItem:[REFloatItem itemWithTitle:@"Float item" value:0.3 sliderValueChangeHandler:^(REFloatItem *item) {
    NSLog(@"Value: %f", item.value);
}]];

Contact

Roman Efimov

License

RETableViewManager is available under the MIT license.

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.