FxForm

List of managed fields.

Bound fields in proper tab order.

Initializes an FxForm.

let fields = viewModel.setup(contact: contact)
form = FxForm(fields, viewController: self, scrollView: scrollView)

Convenience method to clear all of a form’s bound fields. Will not clear unbound field values.

Returns FxField with the given id. Note that this field is returned from the managed fields list and may not neccesarily be bound to any particular view or control.

Returns iterator that will sequence through all bound FxField‘s in tab order.

Runs through our list of fields and returns the current responder, if any.

Undocumented

Gets the current responder and tabs to the next available responder. If none found resigns current responder.

Gets the current responder and tabs to the next previous responder. If none found resigns current responder.

Adds a hide keyboard tap gesture handler to the specified view.

form.autoBind()
    .addHideKeyboardGesture()

If no view is specified the gesture is added to the scrollview or if that doesn’t exist, to the view controller’s view.

Sets up fields to automatically validate when any change is made.

Sets up fields to automatically validate when user leaves its associated textfield or any change is made.

Sets up fields to automatically validate when user leaves its associated textfield.

Undocumented

Core function used to bind specific FxField’s to specific views.

form.bind(.state, .stateTextField)
    .bind(.zip, zipCodeTextField)
    .bind(.text, displayTextField) { _ in return [.viewToField, .error] }

Field values are automatially bound to textfields and other controls using the FxBindableValue protocol.

Note that the order in which fields are bound controls the tab order.

Convenience method to bind the specified FxField’s error message to a specfifc label.

form.autoBind()
    .bindError(.zip, zipErrorLabel)

Convenience method to bind the specified FxField’s isEnabled flag to a specfifc control.

form.autoBind()
    .bindIsEnabled(.zip, zipTextField)

Convenience method to bind the specified FxField’s isHidden flag to a specfifc view.

form.autoBind()
    .bindIsHidden(.zip, zipStackView)

Convenience method to bind the specified FxField’s title to a specfifc label.

form.autoBind()
    .bindTitle(.zip, zipLabel)

Convenience method to bind the specified FxField’s value to a specfifc button.

form.autoBind()
    .bindValue(.zip, zipLabel)

Convenience method to bind the specified FxField’s value to a specfifc label.

form.autoBind()
    .bindValue(.zip, zipLabel)

Performs automated binding of managed fields and views.

This method walks the list of managed fields and searches the view controller’s IBOutlets for views whose names match field.key + suffix.

If found, the field is automatically bound to that view.

form.autoBind()

Note that tab order is controlled by IBOutlet order in the UIViewController.

If a different order is required use autoBind(ids:suffix:custom) or bind fields to views manually.

Performs semi-auotmatic binding of specified fields and views.

This method finds the matching field for each provided id, then searches the view controller’s IBOutlets for views whose names match field.key + suffix.

If found, the field is automatically bound to that view.

form.autoBind(ids: [.firstname, .lastname])

The list order will be the tab order.

Convenience function to automatically change the background color of bound fields if those fields are invalid.

form.autoBind()
    .autoBindErrorColors()

Methods like this one are useful, but exist more to show what can be done with Rx and a list of managed fields and views.

Convenience function to automatically hide the superviews of fields that are hidden.

form.autoBind()
    .autoBindIsHiddenToSuperviews()

If, for example, your fields are in views with an accompanying label, doing field.isHidden = true would hide the bound view’s parent, hiding both the field and its label.

Methods like this one are useful, but exist more to show what can be done with Rx and a list of managed fields and views.

Note: Bind all fields before calling this method.

Convenience function to automatically bind field titles to specfic labels.

form.autoBind()
    .autoBindTitles()

This method walks through the list of managed fields and searches the view controller’s IBOutlets for labels whose names match field.key + suffix.‘

Methods like this one are useful, but exist more to show what can be done with Rx and a list of managed fields and views.

Note: Bind all fields before calling this method.

Convenience function to automatically tab to the next field when a field’s max width is reached and the field is valid.

form.autoBind()
    .autoNext()

This is useful for text entry when the field length is fixed, like a credit card expiration date (12/2014).

Note: Bind all fields before calling this method.

Adds the specfied input accessory view to all bound text fields and text views.

form.autoBind()
    .addInputAccessoryView()

Automatically sets delegate if accessory view conforms to FxInputAccessoryViewInterface.

Note: Bind all fields before calling this method.