iBureaucrat

A forms library for iOS.

##Status?

Still alpha, but stable API
iPad not yet supported (though this will be very simple to add).

#Why?

Nobody likes filling out forms. Or making them. iBureaucrat lets you rapidly create forms for you iOS apps - so you can get back to the fun stuff.

Using tableviews is the defacto standard way to layout forms for iOS, and they look great. But for every project there's a lot of boiler-plate code to set up - different kinds of table-view cells, custom input views, automatically scrolling to accommodate the keyboard/inputview, etc. . It ends up being the same old plumbing code over and over.

There are a few fantastic forms libraries for iOS. This one attempts to be:

Simple and fast to set up forms.
Easy to customize by defining new types, look-and-feel, etc.

#Usage

###Create a view controller

Create a view controller
Add a BCFormView to the view controller's view.
Give the BCFormView a form, as follows:

- (void)viewDidLoad
{
    [super viewDidLoad];
    FundsTransferView* view = (FundsTransferView*) self.view;

    _form = [BCForm new]; //Using default colors.
    _form.delegate = self;
    [_form addSection:[self createTransportDetailsSection]];
    [_form addSection:[self createDetailsSection]];
    
    view.formView.form = _form;
}

- (BCFormSection*)createTransportDetailsSection
{
    BCFormSection* transportDetailsSection = [BCFormSection sectionWithTitle:@"Transport Details"];
    _sendBy = [BCPickerField fieldWithLabel:@"Send by"];
    [_sendBy addOption:[Vehicle vehicleWithName:@"Horse" traits:@"grain tax"]];
    [_sendBy addOption:[Vehicle vehicleWithName:@"Scoundrel" traits:@"reliable"]];
    [_sendBy addOption:[Vehicle vehicleWithName:@"Ship" traits:@"not good over-land"]];

    _notes = [BCTextField fieldWithLabel:@"Notes"];
    [transportDetailsSection addFields:@[_sendBy, _notes]];
    return transportDetailsSection;
}

###Add Delegate methods if you like:

#pragma mark <BCFormDelegate>

- (void)didSelectDone
{
    NSLog(@"Delegate call for done. Field: %@", [_sendBy value]);
}

- (void)didSelectPreviousField
{
    NSLog(@"Delegate call for previous");
}

- (void)didSelectNextField
{
    NSLog(@"Delegate call for next");
}

#Creating your own types

There's an abstract base-class designed to be extended.

#Installation:

iBureaucrat is availble via CocoaPods (recommended)
Otherwise, copy the source files to your project directory. Add the QuartzCore and CoreGraphics frameworks.

Authors

Jasper Blues - jasper@appsquick.ly

With contributions from:

Your name here!!!!!!!

Thanks!!!

LICENSE

Apache License, Version 2.0, January 2004, http://www.apache.org/licenses/

johndoran/iBureaucrat

iBureaucrat

Authors

With contributions from:

LICENSE