Files
RestKit/Code/UI/RKControlTableItem.m
Blake Watters 3d0f0ab39e Introduced the RKTableController component for iOS.
RKTableController provides a flexible, integrated system for driving iOS table views using
the RestKit object mapping engine. Local domain objects can be mapped into table cells within a
collection or presented for editing as part of a form. There are three flavors of table controllers
available:

* Static Tables: RKTableController can be used to render simple static tables that are composed of RKTableItems
presented in RKTableSections. Table items can quickly be built and added to a table without a backing model
or can have content object mapped into them for presentation.
* Network Tables: RKTableController can also render a table with the results of a network load. The typical use
case here is to have RestKit retrieve a JSON/XML payload from your remote system and then render the content into
a table.
* Core Data Tables: RKFetchedResultsTableController can efficiently drive a table view using objects pulled from a
Core Data managed object context. Typical use-cases here are for the presentation of large collections that are
pulled from a remote system, offering offline access, or speeding up a UI by using Core Data as a fast local cache.

RKTableController supports a number of bells and whistles including integrated searching/filtering and pull to refresh.
2012-02-10 16:30:54 -05:00

104 lines
3.1 KiB
Objective-C

//
// RKControlTableItem.m
// RestKit
//
// Created by Blake Watters on 8/22/11.
// Copyright (c) 2011 RestKit.
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
// http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.
//
#import "RKControlTableItem.h"
#import "RKTableViewCellMapping.h"
#import "RKControlTableViewCell.h"
@implementation RKControlTableItem
@synthesize control = _control;
+ (id)tableItemWithControl:(UIControl *)control {
RKControlTableItem *tableItem = [self tableItem];
tableItem.control = control;
return tableItem;
}
- (id)init {
self = [super init];
if (self) {
self.cellMapping.selectionStyle = UITableViewCellSelectionStyleNone;
self.cellMapping.accessoryType = UITableViewCellAccessoryNone;
self.cellMapping.cellClass = [RKControlTableViewCell class];
// Link the UITableViewCell for this table item with the control
[self.cellMapping addPrepareCellBlock:^(UITableViewCell *cell) {
if ([cell respondsToSelector:@selector(setControl:)]) {
[cell setValue:self.control forKey:@"control"];
}
}];
}
return self;
}
- (void)dealloc {
[_control release];
[super dealloc];
}
- (void)setControl:(UIControl *)control {
NSAssert(control, @"Cannot add a nil control to a RKControlTableItem");
[control retain];
[_control release];
_control = control;
}
#pragma mark - Convenience Accessors
- (UIButton *)button {
return ([self.control isKindOfClass:[UIButton class]]) ? (UIButton *) self.control : nil;
}
- (UITextField *)textField {
return ([self.control isKindOfClass:[UITextField class]]) ? (UITextField *) self.control : nil;
}
- (UISwitch *)switchControl {
return ([self.control isKindOfClass:[UISwitch class]]) ? (UISwitch *) self.control : nil;
}
- (UISlider *)slider {
return ([self.control isKindOfClass:[UISlider class]]) ? (UISlider *) self.control : nil;
}
- (UILabel *)label {
return ([self.control isKindOfClass:[UILabel class]]) ? (UILabel *) self.control : nil;
}
// TODO: What if we replace this with a protocol that enables KVC
// via the 'controlValue' property for the common types to allow pluggability?
- (id)controlValue {
if ([self.control isKindOfClass:[UIButton class]]) {
return nil;
} else if ([self.control isKindOfClass:[UITextField class]]) {
return self.textField.text;
} else if ([self.control isKindOfClass:[UISlider class]]) {
return [NSNumber numberWithFloat:self.slider.value];
} else if ([self.control isKindOfClass:[UISwitch class]]) {
return [NSNumber numberWithBool:self.switchControl.isOn];
}
return nil;
}
@end