motion-form

RubyMotion forms made easy.

motion-form is heavily inspired by the gem simple_form for Rails.

It aims to bring a simple, yet flexible DSL to the tedious task of creating iOS forms.

motion-form's initial development was sponsored by dscout. Many thanks to them!

Usage

form = MotionForm.form_for(view) do |form|
  # If you don't want section header views, leave the section name blank
  # Ex: form.section do |section|

  form.section 'Profile' do |section|
    section.input :name,      label: 'Your name', value: 'David Copperfield'
    section.input :username,  label: 'A username'
    section.input :pinterest, label: 'Pinterest username'
    section.input :twitter,   label: 'Twitter username'
    section.input :website,   label: 'Personal website'
    section.text  :bio,       placeholder: 'Write a short bio...'

    section.button :submit, action: submit
  end

  form.section 'Account' do |section|
    section.button :change_email, action: push_email_controller
    section.button :change_password, action: push_password_controller
  end
end

def submit
  -> do
    form.render # { name:      'Devon',
                #   username:  'dblandin',
                #   pinterest: '',
                #   twitter:   'dblandin',
                #   website:   'http://github.com/dblandin',
                #   bio:       'Rubyist in Chicago' }
  end
end

def push_email_controller
  -> do
    # push controller
  end
end

def push_password_controller
  -> do
    # push controller
  end
end

Rendering the Form

Calling #render on any form will return a hash of it's input.

Here's an example using BubbleWrap:

data = form.render

p "Creating account for #{data[:email]}"

BW::HTTP.post("http://foo.bar.com/", { payload: data }) do |response|
  if response.ok?
    json = BW::JSON.parse(response.body.to_str)

    App.alert "Thanks for signing up #{json['display_name']}!"
  else
    App.alert("Login failed")
  end
end

Validation

You can add validation rules to input fields.

The following syntax is supported:

awesomeness_validator = -> (value) do
  # validate awesomeness
end

submit = -> do
  if @form.valid?
    # submit form
  end
end

@form = MotionForm.form_for(view) do |form|
  form.section do |section
    section.input :name,        required: true  # present and not blank
    section.input :email,       email: true     # valid email address
    section.input :website,     url: true       # valid url
    section.input :age,         format: /^\d+$/ # matches regex
    section.input :awesomeness, validate_with: awesomeness_validator # custom validator

    section.button :submit, action: submit
  end
end

Configuration

MotionForm.config do |config|
  config.section_header_color      = UIColor.blueColor
  config.section_header_text_color = UIColor.whiteColor
  config.button_text_color         = UIColor.redColor
end

Installation

Add this line to your application's Gemfile:

gem 'motion-form'

And then execute:

$ bundle

Or install it yourself as:

$ gem install motion-form

Contributing

1. Fork it
2. Create your feature branch (git checkout -b my-new-feature)
3. Commit your changes (git commit -am 'Add some feature')
4. Push to the branch (git push origin my-new-feature)
5. Create new Pull Request

Thanks

dscout - for their sponsorship