| TestsTested | ✓ |
| LangLanguage | Obj-CObjective C |
| License | MIT |
| ReleasedLast Release | Apr 2017 |
Maintained by Ilya Sedov.
This is UITableViewDataSource/UITableViewDelegate form constructor solution. It allows to use UITableView/UITableViewCell customization abilities. We provide several basic Cells. If you haven't found any particular form UI element you can easily create it by yourself with familiar tools like InterfaceBuilder (using cell xibs) or by subclassing UITableViewCell. And pull-requests are welcome!
Form configuration and logic can be implemented in declarative way. Can be placed in separate module and reused in different view controllers.
You have two options to try lib:
$ git clone [email protected]:setoff/EasyForm.git
$ cd EasyForm/Example
$ pod install
$ open EasyForm.xcworkspaceor
$ pod try EasyFormAfter workspace has been opened select EasyForm-Example target and run app.
EFForm implements UITableViewDelegate and UITableViewDataSource protocols. So you can easily use form with any instance of UITableView. But it is recommended to use with UITableViewController (or subclasses) because of several ‘free’ features like scrolling to focused text field which placed in UITableViewCell.
Form implementation structure looks like this:
self.form = [EFForm new];
// Config form items
EFElement *input = [[EFElement alloc] initWithTag:@"inputField"
cellClass:[EFTextFieldCell class]];
input.setupCell = ^(UITableViewCell *cell) {
((EFTextFieldCell *)cell).textField.placeholder = @"Tap to start typing";
};
EFElement *switchElement = [[EFElement alloc] initWithTag:@"switch"
cellClass:[EFSwitchCell class]];
switchElement.setupCell = ^(UITableViewCell *cell) {
((EFSwitchCell *)cell).titleLabel.text = @"Cell with switch";
((EFSwitchCell *)cell).switchToggle.onTintColor = [EFExampleHelpers greenColor];
((EFSwitchCell *)cell).onToggle = ^(BOOL isOn) {
[self.presentingController alertAction:[NSString stringWithFormat:@"Toggle is %@",
isOn ? @"ON" : @"OFF"]];
};
};
// Config section and add form elements
EFSection *inputSection = [[EFSection alloc] initWithTag:@"predefined"
elements:@[input, switchElement]];
inputSection.title = @"Form section";
// Add sections to form
self.form.sections = @[inputSection];
[self.tableView displayForm:self.form];EasyForm is available through CocoaPods. To install
it, simply add the following line to your Podfile:
pod "EasyForm"EasyForm is available under the MIT license. See the LICENSE file for more info.