Formkit

Objective-C library for easily building forms UI.

Transcript

1. Hi. Meiwin @meiwin meiwin@blockthirty.com Hong Wei @hongweizhuo kuangtoh@gmail.com
2. Formkit Usual boring forms, little less painful https://github.com/zhuohongwei/Formkit
3. semantic-ui.com “A form is a collection of user input elements.”
5. Observations/Problems • Typically most forms are rows of field • Field is usually combination of label and input control • They look trivial, but not so trivial to implement • UI interactions (sometimes) require quite some code too
6. Motivation/Goals • To make form creation trivial, less effort • To start minimum, consistent iteration over time • No/minimal third-party dependency • Easy to extend • Open-source
7. • Example: FKForm *form = [[FKForm alloc] init]; form.title = @"Sign In"; FKRowItem *row1 = [form addRow]; [row1 addColumnWithItem:[FKTextFieldItem textFieldItemWithName:@"username" label:@"Username" text:nil placeholder:@"Email address"]]; FKRowItem *row2 = [form addRow]; [row2 addColumnWithItem:[FKTextFieldItem textFieldItemWithName:@"password" label:@"Password" text:nil placeholder:nil]]; form.purpose = FKFormPurposeSubmit; form.submitLabel = @“Sign In”;
9. Design • It’s a tree of items with FKForm as the root • Form contains 0-N rows • Row contains 0-N columns • Column contains 1 item • FKInputItem represents user input element
10. FKInputItem Classes • FKTextFieldItem • FKSelectFieldItem • FKMultiSelectFieldItem • FKInlineSelectFieldItem • FKInlineMultiSelectFieldItem • FKSwitchFieldItem
11. Form API • setValues: • allValues • setValue:forInputItemNamed: • inputItemNamed: • reload
12. Form callbacks • FKFormDelegate protocol • form:didFocusItem: • form:didDefocusItem: • form:valueDidChangedForItem:
13. FKFormViewController • Convenient base class • Manage instance of FKForm • Convenient methods to present success/error message • Conforms to FKFormDelegate
14. Demo