FormKit.m is a library that helps building form with table view.
Objective-C Other
Switch branches/tags
Nothing to show
Pull request Compare This branch is 50 commits behind brunow:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
FormKit.xcworkspace
FormKit
FormKitDemo.xcodeproj
FormKitDemo
FormKitDemoTests
Kiwi
Tests
Vendor
.gitignore
FormKit.m.podspec
LICENSE
README.md
form-mapping.png
form-select.png

README.md

FormKit.m

FormKit.m is a library that helps building forms with a table view.

It also handles synchronization of data between your model and the view (cells) when the user makes edits.

This library is extracted from BaseKit.

Installation

Copy FormKit dir into your project.

Example code

self.formModel = [FKFormModel formTableModelForTableView:self.tableView navigationController:self.navigationController];

[FKFormMapping mappingForClass:[Movie class] block:^(FKFormMapping *mapping) {
    [mapping sectiontWithTitle:@"Information section" identifier:@"info"];
    [mapping mapAttribute:@"title" title:@"Title" type:FKFormAttributeMappingTypeText];
    [mapping mapAttribute:@"releaseDate" title:@"ReleaseDate" FKFormAttributeMappingTypeDate];
    [mapping mapAttribute:@"suitAllAges" title:@"All ages" type:FKFormAttributeMappingTypeBoolean];
    
    // Read-only field
    [mapping mapAttribute:@"shortName" title:@"ShortName" type:FKFormAttributeMappingTypeLabel];
    
    [mapping mapAttribute:@"numberOfActor" title:@"Number of actor" type:FKFormAttributeMappingTypeInteger];
    [mapping mapAttribute:@"content" title:@"Content" type:FKFormAttributeMappingTypeBigText];
    
    // Select fields using a picker or pushing a selection view controller
    [formMapping mapAttribute:@"choice"
                        title:@"Choices"
                 showInPicker:NO
            selectValuesBlock:^NSArray *(id value, id object, NSInteger *selectedValueIndex){
                *selectedValueIndex = 1;
                return [NSArray arrayWithObjects:@"choice1", @"choice2", nil];
    } valueFromSelectBlock:^id(id value, id object, NSInteger selectedValueIndex) {
        return value;
    } labelValueBlock:^id(id value, id object) {
        return value;
    }];
    
    [mapping buttonSave:@"Save" handler:^{
    }];

   [formMapping validationForAttribute:@"title" validBlock:^BOOL(id value, id object) {
        return YES;
    }];
    
    [self.formModel registerMapping:mapping];
}];

[self.formModel loadFieldsWithObject:movie];

Form Mapping

Migrating form BaseKit FormMapping

The biggest change is that classes are now prefixed with FK instead of BK.

ARC

FormKit is ARC only and requires iOS 5.

Changelog

  • Master branch

Contact

Bruno Wernimont

Contributors