RETableViewManager allows to manage content of UITableView with ease, both forms and lists. In its core RETableViewManager supports reusable cells based on corresponding data object class.

The general idea is to allow developers use their own UITableView and UITableViewController instances, providing a layer that synchronizes data and cell appereance.

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

Requirements

Xcode 4.5 or higher
Apple LLVM compiler
iOS 5.0 or higher
ARC

API Quickstart

RETableViewManager is broken into several modules. Key classes in each module are highlighted below.

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`.
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 options using `RETableViewOptionsController`.
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

Simple Example

Subclass UITableViewController, remove all code inside of the implementation section and paste just this (yes, now it's that easy to manage UITableView content):

- (void)viewDidLoad
{
    [super viewDidLoad];
    // 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 basic cell with disclosure indicator
    //
    [section addItem:[RETableViewItem itemWithTitle:"String cell" accessoryType:UITableViewCellAccessoryDisclosureIndicator actionBlock:^(RETableViewItem *item) {
        NSLog(@"Test: %@", item);
    }]];
}

More Complex Example

// Create 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 section
//
RETableViewSection *section = [[RETableViewSection alloc] initWithHeaderTitle:@"Test"];
[_tableViewManager addSection:section];

// Add simple string item
//
[section addItem:@"Test"];

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

// Add editable table cell (using UITextField)
//
[section addItem:[RETextItem itemWithTitle:@"Enter text" value:@""]];

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

// Add radio cell (options)
//
__typeof (&*self) __weak weakSelf = self;
RERadioItem *optionItem = [RERadioItem itemWithTitle:@"Radio" value:@"Option 4" actionBlock:^(RETableViewItem *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.detailLabelText = selectedItem.title;
      [weakSelf.tableView reloadRowsAtIndexPaths:@[item.indexPath] withRowAnimation:UITableViewRowAnimationNone];
  }];
  [weakSelf.navigationController pushViewController:optionsController animated:YES];
}];
[section addItem:optionItem];


// Add another section
//
RETableViewSection *section2 = [[RETableViewSection alloc] initWithHeaderTitle:@"Section 2"];
section2.footerTitle = @"Hey, I'm a footer";
[_tableViewManager addSection:section2];

// It's super easy to create custom mappings, for example
// this how all NSString objects are being matched with RETableViewStringCell
//
[_tableViewManager mapObjectClass:@"NSString" toTableViewCellClass:@"RETableViewStringCell"];

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.