ProMotion-XLForm 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: b72f5d70e733afcd851aff9900f8b13b19fbed0b
+  data.tar.gz: 2b63d7b46c59924fb9839f45e2f358a135f34028
+SHA512:
+  metadata.gz: 341ac2b44c3f2f74cf667351d087d6ee239ef4237fe5fb690c8dd4736ff941c23f164fb8c095e367230155c42b728ef36775b2a44fb9b3b757425da8ee92407f
+  data.tar.gz: 63926ccbdea5af6926c5f75de41415d6eae24b797421f29c7e4aafe508d34628bf859532ea49aa02572994b08423816d35e33c1398017570e6ab6aa9d8a9d1c0

data/README.md

@@ -0,0 +1,227 @@
+# ProMotion-XLForm
+
+ProMotion-XLForm provides a PM::XLFormScreen for [ProMotion](https://github.com/clearsightstudio/ProMotion) powered by the CocoaPod [XLForm](https://github.com/xmartlabs/XLForm).
+
+## Warning
+This gem is currently in very early-stage. Use it at your own risk :)
+
+## Installation
+
+```ruby
+gem 'ProMotion-form'
+```
+
+Then:
+
+```sh-session
+$ bundle
+$ rake pod:install
+```
+
+## Usage
+
+`PM::XLFormScreen` include `PM::ScreenModule` so you'll have all ProMotion methods available.
+
+To create a form, create a new `PM::XLFormScreen` and implement `form_data`.
+
+```ruby
+class TestFormScreen < PM::XLFormScreen
+  def form_data
+  [
+    {
+      title:  'Account information',
+      cells: [
+        {
+          title:       'Email',
+          name:        :email,
+          type:        :email,
+          placeholder: 'Enter your email',
+          required:    true
+        },
+        {
+          title: 'Name',
+          name:  :name,
+          type:  :text,
+          value: 'Default value'
+        },
+        {
+          title: 'Sex',
+          name: :sex,
+          type: :selector_push,
+          options: {
+          male: 'Male',
+          female: 'Female',
+          other: 'Other'
+        }
+      ]
+    }
+  ]
+  end
+end
+```
+
+## Available types
+* :text
+* :name
+* :url
+* :email
+* :password
+* :number
+* :phone
+* :twitter
+* :account
+* :integer
+* :decimal
+* :textview
+* :selector_push
+* :selector_popover
+* :selector_action_sheet
+* :selector_alert_view
+* :selector_picker_view
+* :selector_picker_view_inline
+* :multiple_selector
+* :multiple_selector_popover
+* :selector_left_right
+* :selector_segmented_control
+* :date_inline
+* :datetime_inline
+* :time_inline
+* :countdown_timer_inline
+* :date
+* :datetime
+* :time
+* :countdown_timer
+* :datepicker
+* :picker
+* :slider
+* :check
+* :switch
+* :button
+* :info
+* :step_counter
+* :image
+
+### Class options
+
+```ruby
+class TestFormScreen < PM::XLFormScreen
+
+  form_options required:  :asterisks, # add an asterisk to required fields
+               on_save:   :'save_form:', # will be called when you touch save
+               on_cancel: :cancel_form # will be called when you touch cancel
+
+   def save_form(values)
+     mp values
+   end
+
+   def cancel_form
+   end
+end
+```
+
+### Getting values
+
+You can get the values of your form with `values`. You can also get validation errors with `validation_errors` and check if the form is valid with `valid?`
+
+### Events
+
+`on_change`, `on_add` and `on_remove` are available for cells, `on_add` and `on_remove` are available for sections.
+
+```ruby
+{
+  title: 'Sex',
+  name: :sex,
+  type: :selector_push,
+  options: {
+    male: 'Male',
+    female: 'Female',
+    other: 'Other'
+  },
+  on_change: lambda do |old_value, new_value|
+    puts "Changed from #{old_value} to #{new_value}"
+  end
+}
+```
+
+### Multivalued Sections (Insert, Delete, Reorder rows)
+
+```ruby
+{
+  title:  'Multiple value',
+  name:   :multi_values,
+  options: [:insert, :delete, :reorder],
+  cells: [
+    {
+      title: 'Add a new tag',
+      name:  :tag,
+      type:  :text
+    }
+  ]
+}
+```
+
+### Custom Selectors
+
+You can create a custom _subform_ with a few options
+
+```ruby
+{
+  title: 'Custom',
+  name:  :custom,
+  cells: [
+    {
+        title: 'Some text',
+        name:  :some_text,
+        type:  :text
+    },
+    {
+        title: 'Other text',
+        name:  :some_other_text,
+        type:  :text
+    }
+  ]
+}
+```
+
+By default, the cell will print a `Hash.inspect` of your _subcells_. You can change this by creating a valueTransformer and set `value_transformer:`.
+
+```ruby
+{
+  title: 'Custom',
+  name:  :custom,
+  value_transformer: MyValueTransformer
+  cells: []
+}
+
+class MyValueTransformer < PM::ValueTransformer
+  def transformedValue(value)
+    return nil if value.nil?
+
+    str = []
+    str << value['some_text'] if value['some_text']
+    str << value['some_other_text'] if value['some_other_text']
+
+    str.join(',')
+  end
+end
+```
+
+For a more advanced custom selector, you can set `view_controller_class:`. See [XLForm documentation](https://github.com/xmartlabs/XLForm/#custom-selectors---selector-row-with-a-custom-selector-view-controller) for more informations.
+
+## Todo
+- Validations
+- Tests
+- A lot of other things :)
+
+## 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. Make some specs pass
+5. Push to the branch (`git push origin my-new-feature`)
+6. Create new Pull Request
+
+## License
+
+Released under the [MIT license](LICENSE).

data/lib/ProMotion-XLForm.rb

@@ -0,0 +1,22 @@
+# encoding: utf-8
+unless defined?(Motion::Project::Config)
+  raise "ProMotion-XLForm must be required within a RubyMotion project."
+end
+require 'motion-cocoapods'
+
+Motion::Project::App.setup do |app|
+  lib_dir_path = File.dirname(File.expand_path(__FILE__))
+  app.files << File.join(lib_dir_path, "ProMotion/XLForm/cells/xl_form_image_selector_cell.rb")
+  app.files << File.join(lib_dir_path, "ProMotion/XLForm/xl_form_class_methods.rb")
+  app.files << File.join(lib_dir_path, "ProMotion/XLForm/xl_form_module.rb")
+  app.files << File.join(lib_dir_path, "ProMotion/XLForm/xl_form_view_controller.rb")
+  app.files << File.join(lib_dir_path, "ProMotion/XLForm/xl_form.rb")
+  app.files << File.join(lib_dir_path, "ProMotion/XLForm/xl_form_screen.rb")
+  app.files << File.join(lib_dir_path, "ProMotion/XLForm/xl_sub_form_screen.rb")
+  app.files << File.join(lib_dir_path, "ProMotion/XLForm/xl_form_patch.rb")
+  app.files << File.join(lib_dir_path, "ProMotion/XLForm/value_transformer.rb")
+
+  app.pods do
+    pod 'XLForm', '~> 3.0.0'
+  end
+end

data/lib/ProMotion/XLForm/cells/xl_form_image_selector_cell.rb

@@ -0,0 +1,227 @@
+class XLFormImageSelectorCell < XLFormBaseCell
+
+  attr_accessor :imageview, :text_label
+
+  def configure
+    super
+    @image_height        = 100.0
+    @image_width         = 100.0
+    self.selectionStyle  = UITableViewCellSelectionStyleNone
+    self.backgroundColor = UIColor.whiteColor
+    self.separatorInset  = UIEdgeInsetsZero
+
+    self.contentView.addSubview(imageview)
+    self.contentView.addSubview(text_label)
+    text_label.addObserver(self, forKeyPath: "text", options: NSKeyValueObservingOptionOld | NSKeyValueObservingOptionNew, context: 0)
+  end
+
+  def update
+    text_label.text = self.rowDescriptor.title
+    imageview.image = self.rowDescriptor.value
+
+    text_label.setFont(UIFont.preferredFontForTextStyle(UIFontTextStyleBody))
+    text_label.sizeToFit
+    updateConstraints
+  end
+
+  def self.formDescriptorCellHeightForRowDescriptor(_)
+    120.0
+  end
+
+  def formDescriptorCellDidSelectedWithFormController(controller)
+    if NSFoundationVersionNumber <= NSFoundationVersionNumber_iOS_7_1
+      alert = UIAlertController.alertControllerWithTitle(self.rowDescriptor.selectorTitle,
+                                                         message:        nil,
+                                                         preferredStyle: UIAlertControllerStyleActionSheet)
+
+      alert.addAction(UIAlertAction.actionWithTitle(NSLocalizedString("Choose From Library", nil),
+                                                    style:   UIAlertActionStyleDefault,
+                                                    handler: lambda { |_|
+                                                      self.formViewController.dismissViewControllerAnimated(true,
+                                                                                                            completion: -> {
+                                                                                                              open_picker(UIImagePickerControllerSourceTypePhotoLibrary)
+                                                                                                            })
+                                                    }))
+
+      if UIImagePickerController.isSourceTypeAvailable(UIImagePickerControllerSourceTypeCamera)
+        alert.addAction(UIAlertAction.actionWithTitle(NSLocalizedString("Take Photo", nil),
+                                                      style:   UIAlertActionStyleDefault,
+                                                      handler: lambda { |_|
+                                                        self.formViewController.dismissViewControllerAnimated(true,
+                                                                                                              completion: -> {
+                                                                                                                open_picker(UIImagePickerControllerSourceTypeCamera)
+                                                                                                              })
+                                                      }))
+      end
+      if self.formViewController.presentedViewController
+        self.formViewController.dismissViewControllerAnimated(true,
+                                                              completion: -> {
+                                                                self.formViewController.presentViewController(alert, animated: true, completion: nil)
+                                                              })
+      else
+        self.formViewController.presentViewController(alert, animated: true, completion: nil)
+      end
+
+    else
+      if UIImagePickerController.isSourceTypeAvailable(UIImagePickerControllerSourceTypeCamera)
+        action_sheet = UIActionSheet.alloc.initWithTitle(self.rowDescriptor.selectorTitle,
+                                                         delegate:               self,
+                                                         cancelButtonTitle:      NSLocalizedString("Cancel", nil),
+                                                         destructiveButtonTitle: nil,
+                                                         otherButtonTitles:      NSLocalizedString("Choose From Library", nil), NSLocalizedString("Take Photo", nil), nil)
+      else
+        action_sheet = UIActionSheet.alloc.initWithTitle(self.rowDescriptor.selectorTitle,
+                                                         delegate:               self,
+                                                         cancelButtonTitle:      NSLocalizedString("Cancel", nil),
+                                                         destructiveButtonTitle: nil,
+                                                         otherButtonTitles:      NSLocalizedString("Choose From Library", nil), nil)
+      end
+      action_sheet.tag = self.tag
+      action_sheet.showInView(self.formViewController.view)
+    end
+  end
+
+  def updateConstraints
+    ui_components = { "image" => imageview, "text" => text_label }
+
+    self.contentView.addConstraints(NSLayoutConstraint.constraintsWithVisualFormat("H:|-16-[text]", options: 0, metrics: 0, views: ui_components))
+    self.contentView.addConstraints(NSLayoutConstraint.constraintsWithVisualFormat("V:|-6-[text]", options: 0, metrics: 0, views: ui_components))
+
+    self.contentView.addConstraint(NSLayoutConstraint.constraintWithItem(imageview,
+                                                                         attribute:  NSLayoutAttributeTop,
+                                                                         relatedBy:  NSLayoutRelationEqual,
+                                                                         toItem:     self.contentView,
+                                                                         attribute:  NSLayoutAttributeTop,
+                                                                         multiplier: 1.0,
+                                                                         constant:   10.0))
+
+    self.contentView.addConstraint(NSLayoutConstraint.constraintWithItem(imageview,
+                                                                         attribute:  NSLayoutAttributeBottom,
+                                                                         relatedBy:  NSLayoutRelationEqual,
+                                                                         toItem:     self.contentView,
+                                                                         attribute:  NSLayoutAttributeBottom,
+                                                                         multiplier: 1.0,
+                                                                         constant:   -10.0))
+
+    self.contentView.addConstraints(NSLayoutConstraint.constraintsWithVisualFormat("H:[image(width)]", options: 0, metrics: { "width" => @image_width }, views: ui_components))
+    self.contentView.addConstraint(NSLayoutConstraint.constraintWithItem(imageview,
+                                                                         attribute:  NSLayoutAttributeCenterX,
+                                                                         relatedBy:  NSLayoutRelationEqual,
+                                                                         toItem:     self.contentView,
+                                                                         attribute:  NSLayoutAttributeCenterX,
+                                                                         multiplier: 1.0,
+                                                                         constant:   0.0))
+    super
+  end
+
+  # trick to force the status bar to be hidden when presenting the UIImagePickerViewController
+  def navigationController(_, willShowViewController: _, animated: _)
+    UIApplication.sharedApplication.setStatusBarHidden true
+  end
+
+  def setImageValue(image)
+    self.rowDescriptor.value = image
+    imageview.image          = image
+  end
+
+  def observeValueForKeyPath(key_path, ofObject: object, change: change, context: _)
+    if object == text_label && key_path == "text"
+      if change[NSKeyValueChangeKindKey] == NSKeyValueChangeSetting
+        text_label.sizeToFit
+        frame            = text_label.frame
+        frame.origin     = [16, 4]
+        text_label.frame = frame
+        self.contentView.needsUpdateConstraints
+      end
+    end
+  end
+
+  def dealloc
+    text_label.removeObserver(self, forKeyPath: "text")
+  end
+
+  # UIActionSheetDelegate
+  def actionSheet(action_sheet, clickedButtonAtIndex: button_index)
+    return if button_index == action_sheet.cancelButtonIndex
+
+    title = action_sheet.buttonTitleAtIndex(button_index)
+
+    case title
+      when NSLocalizedString("Choose From Library", nil)
+        open_picker(UIImagePickerControllerSourceTypePhotoLibrary)
+      when NSLocalizedString("Take Photo", nil)
+        open_picker(UIImagePickerControllerSourceTypeCamera)
+      else
+        return
+    end
+  end
+
+  def open_picker(source)
+    image_picker               = UIImagePickerController.alloc.init
+    image_picker.delegate      = self
+    image_picker.allowsEditing = true
+    image_picker.sourceType    = source
+
+    if UIDevice.currentDevice.userInterfaceIdiom == UIUserInterfaceIdiomPad
+      if @popover_controller && @popover_controller.isPopoverVisible
+        @popover_controller.dismissPopoverAnimated(true)
+      end
+      @popover_controller = UIPopoverController.alloc.initWithContentViewController(image_picker)
+      Dispatch::Queue.main.async do
+        @popover_controller.presentPopoverFromRect(self.contentView.frame,
+                                                   inView:                   self.formViewController.view,
+                                                   permittedArrowDirections: UIPopoverArrowDirectionAny,
+                                                   animated:                 true)
+      end
+    else
+      if self.formViewController.presentedViewController
+        self.formViewController.dismissViewControllerAnimated(true,
+                                                              completion: -> {
+                                                                self.formViewController.presentViewController(image_picker,
+                                                                                                              animated:   true,
+                                                                                                              completion: nil)
+                                                              })
+      else
+        self.formViewController.presentViewController(image_picker,
+                                                      animated:   true,
+                                                      completion: nil)
+      end
+    end
+  end
+
+  # UIImagePickerControllerDelegate
+  def imagePickerController(_, didFinishPickingMediaWithInfo: info)
+    editedImage   = info[UIImagePickerControllerEditedImage]
+    originalImage = info[UIImagePickerControllerOriginalImage]
+    if editedImage
+      imageToUse = editedImage
+    else
+      imageToUse = originalImage
+    end
+    setImageValue(imageToUse)
+
+    if UIDevice.currentDevice.userInterfaceIdiom == UIUserInterfaceIdiomPad
+      if @popover_controller and @popover_controller.isPopoverVisible
+        @popover_controller.dismissPopoverAnimated(true)
+      end
+    else
+      self.formViewController.dismissViewControllerAnimated(true, completion: nil)
+    end
+  end
+
+  # Properties
+  def imageview
+    return @imageview if @imageview
+
+    @imageview                     = UIImageView.autolayoutView
+    @imageview.layer.masksToBounds = true
+    @imageview.contentMode         = UIViewContentModeScaleAspectFit
+    @imageview
+  end
+
+  def text_label
+    return @text_label if @text_label
+    @text_label = UILabel.autolayoutView
+  end
+
+end

data/lib/ProMotion/XLForm/value_transformer.rb

@@ -0,0 +1,18 @@
+module ProMotion
+  class ValueTransformer
+    def self.transformedValueClass
+      NSString
+    end
+
+    def self.allowsReverseTransformation
+      false
+    end
+
+    def transformedValue(value)
+      return nil if value.nil?
+
+      # best effort
+      value.inspect
+    end
+  end
+end

data/lib/ProMotion/XLForm/xl_form.rb

@@ -0,0 +1,232 @@
+module ProMotion
+  class XLForm
+
+    attr_reader :form_data
+
+    def initialize(form_data, opts={})
+      @form_data = form_data
+      @title     = opts[:title] || ''
+      @required  = opts[:required]
+    end
+
+    def build
+      form                                = XLFormDescriptor.formDescriptorWithTitle(@title)
+      form.addAsteriskToRequiredRowsTitle = (@required == :asterisks)
+
+      form_data.each do |section_data|
+        title = section_data[:title]
+
+        options     = parse_section_options(section_data[:options])
+        insert_mode = section_insert_mode(section_data[:insert_mode])
+
+        section = XLFormSectionDescriptor.formSectionWithTitle(title, sectionOptions: options, sectionInsertMode: insert_mode)
+        if options.nonzero?
+          tag = section_data[:name]
+          mp("MutliValued section with no :name option", force_color: :red) unless tag
+          if tag.respond_to? :to_s
+            tag = tag.to_s
+          end
+          section.multivaluedTag = tag
+        end
+        section.footerTitle = section_data[:footer] if section_data[:footer]
+
+        add_proc section, :on_add, section_data[:on_add] if section_data[:on_add]
+        add_proc section, :on_remove, section_data[:on_remove] if section_data[:on_remove]
+
+        form.addFormSection(section)
+
+        section_data[:cells].each do |cell_data|
+          tag = cell_data[:name]
+          mp("Cell with no :name option", force_color: :red) unless tag
+          if tag.respond_to? :to_s
+            tag = tag.to_s
+          end
+          title = cell_data[:title]
+          type  = cell_data[:type]
+          if type.nil? and cell_data[:cells]
+            type = :selector_push
+          end
+
+          cell = XLFormRowDescriptor.formRowDescriptorWithTag(tag, rowType: row_type(type), title: title)
+
+          cell.required = cell_data[:required]
+
+          properties = cell_data[:properties] || {}
+
+          # placeholder
+          cell.cellConfigAtConfigure.setObject(cell_data[:placeholder], forKey: "textField.placeholder") if cell_data[:placeholder]
+
+          # slider
+          if cell_data[:type] == :slider
+            min  = properties[:min]
+            max  = properties[:max]
+            step = properties[:step]
+            cell.cellConfigAtConfigure.setObject(min, forKey: "slider.minimumValue") if min
+            cell.cellConfigAtConfigure.setObject(max, forKey: "slider.maximumValue") if max
+            cell.cellConfigAtConfigure.setObject(step, forKey: "steps") if step
+          end
+
+          # dates
+          if [:date_inline, :datetime_inline, :time_inline, :date, :datetime, :time, :datepicker].include? cell_data[:type]
+            min = properties[:min]
+            max = properties[:max]
+            cell.cellConfigAtConfigure.setObject(min, forKey: "minimumDate") if min
+            cell.cellConfigAtConfigure.setObject(max, forKey: "maximumDate") if max
+          end
+
+          cell_class = cell_data[:cell_class]
+
+          # image
+          if cell_data[:type] == :image
+            cell_class = XLFormImageSelectorCell if cell_class.nil?
+          end
+
+          cell.cellClass = cell_class if cell_class
+
+          # subcells
+          if cell_data[:cells]
+            cell.action.viewControllerClass = ProMotion::XLSubFormScreen
+            cell.action.cells               = cell_data[:cells]
+            cell.valueTransformer           = ProMotion::ValueTransformer
+          end
+
+          # also accept default XLForm viewControllerClass
+          cell.action.viewControllerClass = cell_data[:view_controller_class] if cell_data[:view_controller_class]
+          cell.valueTransformer           = cell_data[:value_transformer] if cell_data[:value_transformer]
+
+          # callbacks
+          add_proc cell, :on_change, cell_data[:on_change] if cell_data[:on_change]
+          add_proc cell, :on_add, cell_data[:on_add] if cell_data[:on_add]
+          add_proc cell, :on_remove, cell_data[:on_remove] if cell_data[:on_remove]
+
+          cell.selectorTitle   = cell_data[:selector_title] if cell_data[:selector_title]
+          options              = parse_options(cell_data[:options])
+          cell.selectorOptions = options
+
+          value = cell_data[:value]
+          if value and options
+            options.each do |opt|
+              if opt.formValue == value
+                value = opt
+                break
+              end
+            end
+          end
+
+          cell.value    = value if value
+
+          cell.disabled = !cell_data[:enabled] if cell_data[:enabled]
+
+          section.addFormRow(cell)
+
+          # multi sections
+          if section.multivaluedTag
+            cell.action.required           = @required
+            section.multivaluedRowTemplate = cell.copy
+          end
+        end
+      end
+
+      form
+    end
+
+    def get_callback(row, event)
+      return if @blocks.nil? or @blocks[row].nil? or @blocks[row][event].nil?
+
+      @blocks[row][event]
+    end
+
+    private
+
+    def add_proc(tag, event, block)
+      @blocks             ||= {}
+      @blocks[tag]        ||= {}
+      @blocks[tag][event] = block.respond_to?('weak!') ? block.weak! : block
+    end
+
+    def parse_options(options)
+      return nil if options.nil? or options.empty?
+
+      options.map do |key, text|
+        val = key
+        if val.is_a? Symbol
+          val = val.to_s
+        end
+        XLFormOptionsObject.formOptionsObjectWithValue(val, displayText: text)
+      end
+    end
+
+    def parse_section_options(options)
+      return section_options(:none) if options.nil?
+
+      opts = section_options(:none)
+      options.each do |opt|
+        opts |= section_options(opt)
+      end
+
+      opts
+    end
+
+    def section_insert_mode(symbol)
+      {
+          last_row: XLFormSectionInsertModeLastRow,
+          button:   XLFormSectionInsertModeButton
+      }[symbol] || symbol || XLFormSectionInsertModeLastRow
+    end
+
+    def section_options(symbol)
+      {
+          none:    XLFormSectionOptionNone,
+          insert:  XLFormSectionOptionCanInsert,
+          delete:  XLFormSectionOptionCanDelete,
+          reorder: XLFormSectionOptionCanReorder
+      }[symbol] || symbol || XLFormSectionOptionNone
+    end
+
+    def row_type(symbol)
+      {
+          text:                        XLFormRowDescriptorTypeText,
+          name:                        XLFormRowDescriptorTypeName,
+          url:                         XLFormRowDescriptorTypeURL,
+          email:                       XLFormRowDescriptorTypeEmail,
+          password:                    XLFormRowDescriptorTypePassword,
+          number:                      XLFormRowDescriptorTypeNumber,
+          phone:                       XLFormRowDescriptorTypePhone,
+          twitter:                     XLFormRowDescriptorTypeTwitter,
+          account:                     XLFormRowDescriptorTypeAccount,
+          integer:                     XLFormRowDescriptorTypeInteger,
+          decimal:                     XLFormRowDescriptorTypeDecimal,
+          textview:                    XLFormRowDescriptorTypeTextView,
+          selector_push:               XLFormRowDescriptorTypeSelectorPush,
+          selector_popover:            XLFormRowDescriptorTypeSelectorPopover,
+          selector_action_sheet:       XLFormRowDescriptorTypeSelectorActionSheet,
+          selector_alert_view:         XLFormRowDescriptorTypeSelectorAlertView,
+          selector_picker_view:        XLFormRowDescriptorTypeSelectorPickerView,
+          selector_picker_view_inline: XLFormRowDescriptorTypeSelectorPickerViewInline,
+          multiple_selector:           XLFormRowDescriptorTypeMultipleSelector,
+          multiple_selector_popover:   XLFormRowDescriptorTypeMultipleSelectorPopover,
+          selector_left_right:         XLFormRowDescriptorTypeSelectorLeftRight,
+          selector_segmented_control:  XLFormRowDescriptorTypeSelectorSegmentedControl,
+          date_inline:                 XLFormRowDescriptorTypeDateInline,
+          datetime_inline:             XLFormRowDescriptorTypeDateTimeInline,
+          time_inline:                 XLFormRowDescriptorTypeTimeInline,
+          countdown_timer_inline:      XLFormRowDescriptorTypeCountDownTimerInline,
+          date:                        XLFormRowDescriptorTypeDate,
+          datetime:                    XLFormRowDescriptorTypeDateTime,
+          time:                        XLFormRowDescriptorTypeTime,
+          countdown_timer:             XLFormRowDescriptorTypeCountDownTimer,
+          datepicker:                  XLFormRowDescriptorTypeDatePicker,
+          picker:                      XLFormRowDescriptorTypePicker,
+          slider:                      XLFormRowDescriptorTypeSlider,
+          check:                       XLFormRowDescriptorTypeBooleanCheck,
+          switch:                      XLFormRowDescriptorTypeBooleanSwitch,
+          button:                      XLFormRowDescriptorTypeButton,
+          info:                        XLFormRowDescriptorTypeInfo,
+          step_counter:                XLFormRowDescriptorTypeStepCounter,
+          image:                       'XLFormRowDescriptorTypeImage'
+      }[symbol] || symbol
+    end
+
+  end
+
+end

data/lib/ProMotion/XLForm/xl_form_class_methods.rb

@@ -0,0 +1,11 @@
+module XLFormClassMethods
+
+  def form_options(opts={})
+    @form_options = opts
+  end
+
+  def get_form_options
+    @form_options || {}
+  end
+
+end

data/lib/ProMotion/XLForm/xl_form_module.rb

@@ -0,0 +1,9 @@
+module ProMotion
+  module XLFormModule
+
+    def self.included(base)
+      base.extend(XLFormClassMethods)
+    end
+
+  end
+end

data/lib/ProMotion/XLForm/xl_form_patch.rb

@@ -0,0 +1,29 @@
+# Monkey patch
+class XLFormAction
+
+  attr_accessor :cells
+  attr_accessor :required
+
+  alias :old_copyWithZone :copyWithZone
+
+  def copyWithZone(zone)
+    action_copy = old_copyWithZone(zone)
+
+    action_copy.cells    = self.cells.copy
+    action_copy.required = self.required
+    action_copy
+  end
+end
+
+class XLFormRowDescriptor
+
+  alias :old_copyWithZone :copyWithZone
+
+  def copyWithZone(zone)
+    row_descriptor_copy = old_copyWithZone(zone)
+
+    row_descriptor_copy.valueTransformer = self.valueTransformer
+    row_descriptor_copy
+  end
+
+end

data/lib/ProMotion/XLForm/xl_form_screen.rb

@@ -0,0 +1,168 @@
+module ProMotion
+  class XLFormScreen < XlFormViewController
+    include ProMotion::ScreenModule
+    include ProMotion::XLFormModule
+
+    attr_reader :form_object
+
+    def viewDidLoad
+      super
+      update_form_data
+
+      form_options = self.class.get_form_options
+
+      if form_options[:on_cancel]
+        on_cancel = form_options[:on_cancel]
+        title     = NSLocalizedString('Cancel', nil)
+        item      = :cancel
+        if on_cancel.is_a? Hash
+          title = on_cancel[:title] if on_cancel[:title]
+          item  = on_cancel[:item] if on_cancel[:item]
+        end
+
+        set_nav_bar_button :left, {
+                                    system_item: item,
+                                    title:       title,
+                                    action:      'on_cancel:'
+                                }
+      end
+
+      if form_options[:on_save]
+        on_cancel = form_options[:on_save]
+        title     = NSLocalizedString('Save', nil)
+        item      = :save
+        if on_cancel.is_a? Hash
+          title = on_cancel[:title] if on_cancel[:title]
+          item  = on_cancel[:item] if on_cancel[:item]
+        end
+
+        set_nav_bar_button :right, {
+                                     system_item: item,
+                                     title:       title,
+                                     action:      'on_save:'
+                                 }
+      end
+    end
+
+    def form_data
+      PM.logger.info "You need to implement a `form_data` method in #{self.class.to_s}."
+      []
+    end
+
+    def update_form_data
+      form_options = self.class.get_form_options
+      title        = self.class.title
+      required     = form_options[:required]
+
+      @form_builder = PM::XLForm.new(self.form_data,
+                                     {
+                                         title:    title,
+                                         required: required
+                                     })
+      @form_object  = @form_builder.build
+      self.form     = @form_object
+    end
+
+    def values
+      values = {}
+      formValues.each do |key, value|
+        if value.is_a? XLFormOptionsObject
+          value = value.formValue
+        end
+        values[key] = value
+      end
+
+      values
+    end
+
+    def valid?
+      validation_errors.empty?
+    end
+
+    alias :validation_errors :formValidationErrors
+
+    def display_errors
+      return if valid?
+
+      errors = validation_errors.map do |error|
+        error.localizedDescription
+      end
+
+      if NSFoundationVersionNumber > NSFoundationVersionNumber_iOS_7_1
+        alert  = UIAlertController.alertControllerWithTitle(NSLocalizedString('Error', nil),
+                                                            message:        errors.join(', '),
+                                                            preferredStyle: UIAlertControllerStyleAlert)
+        action = UIAlertAction.actionWithTitle(NSLocalizedString('OK', nil),
+                                               style:   UIAlertActionStyleDefault,
+                                               handler: nil)
+        alert.addAction(action)
+        presentViewController(alert, animated: true, completion: nil)
+      else
+        alert         = UIAlertView.new
+        alert.title   = NSLocalizedString('Error', nil)
+        alert.message = errors.join(', ')
+        alert.show
+      end
+    end
+
+    protected
+    def on_cancel(_)
+      form_options = self.class.get_form_options
+      if form_options[:on_cancel]
+        on_cancel = form_options[:on_cancel]
+        if on_cancel.is_a? Hash
+          on_cancel = on_cancel[:action]
+        end
+        try on_cancel
+      end
+    end
+
+    def on_save(_)
+      unless valid?
+        display_errors
+        return
+      end
+
+      form_options = self.class.get_form_options
+      if form_options[:on_save]
+        on_save = form_options[:on_save]
+        if on_save.is_a? Hash
+          on_save = on_save[:action]
+        end
+        try on_save, values
+      end
+    end
+
+    ## XLFormDescriptorDelegate
+    def formSectionHasBeenAdded(section, atIndex: _)
+      super
+      callback = @form_builder.get_callback(section, :on_add)
+      callback.call if callback
+    end
+
+    def formSectionHasBeenRemoved(section, atIndex: _)
+      super
+      callback = @form_builder.get_callback(section, :on_remove)
+      callback.call if callback
+    end
+
+    def formRowHasBeenAdded(row, atIndexPath: _)
+      super
+      callback = @form_builder.get_callback(row, :on_add)
+      callback.call if callback
+    end
+
+    def formRowHasBeenRemoved(row, atIndexPath: _)
+      super
+      callback = @form_builder.get_callback(row, :on_remove)
+      callback.call if callback
+    end
+
+    def formRowDescriptorValueHasChanged(row, oldValue: old_value, newValue: new_value)
+      super
+      callback = @form_builder.get_callback(row, :on_change)
+      callback.call(old_value, new_value) if callback
+    end
+
+  end
+end

data/lib/ProMotion/XLForm/xl_form_view_controller.rb

@@ -0,0 +1,54 @@
+module ProMotion
+  class XlFormViewController < XLFormViewController
+    def self.new(args = {})
+      s = self.alloc.init
+      s.screen_init(args) if s.respond_to?(:screen_init)
+      s
+    end
+
+    def loadView
+      self.respond_to?(:load_view) ? self.load_view : super
+    end
+
+    def viewDidLoad
+      super
+      self.view_did_load if self.respond_to?(:view_did_load)
+    end
+
+    def viewWillAppear(animated)
+      super
+      self.view_will_appear(animated) if self.respond_to?("view_will_appear:")
+    end
+
+    def viewDidAppear(animated)
+      super
+      self.view_did_appear(animated) if self.respond_to?("view_did_appear:")
+    end
+
+    def viewWillDisappear(animated)
+      self.view_will_disappear(animated) if self.respond_to?("view_will_disappear:")
+      super
+    end
+
+    def viewDidDisappear(animated)
+      self.view_did_disappear(animated) if self.respond_to?("view_did_disappear:")
+      super
+    end
+
+    def shouldAutorotateToInterfaceOrientation(orientation)
+      self.should_rotate(orientation)
+    end
+
+    def shouldAutorotate
+      self.should_autorotate
+    end
+
+    def willRotateToInterfaceOrientation(orientation, duration:duration)
+      self.will_rotate(orientation, duration)
+    end
+
+    def didRotateFromInterfaceOrientation(orientation)
+      self.on_rotate
+    end
+  end
+end

data/lib/ProMotion/XLForm/xl_sub_form_screen.rb

@@ -0,0 +1,43 @@
+module ProMotion
+  class XLSubFormScreen < XLFormScreen
+    attr_accessor :rowDescriptor
+
+    def form_data
+      [
+          {
+              title: rowDescriptor.title,
+              cells: rowDescriptor.action.cells.map do |cell|
+                tag = cell[:name]
+                if tag.respond_to? :to_s
+                  tag = tag.to_s
+                end
+                if rowDescriptor and rowDescriptor.value and rowDescriptor.value[tag]
+                  cell.merge({ value: rowDescriptor.value[tag] })
+                else
+                  cell
+                end
+              end
+          }
+      ]
+    end
+
+    def update_form_data
+      title        = rowDescriptor.title
+      required     = rowDescriptor.action.required
+
+      @form_builder = PM::XLForm.new(self.form_data,
+                                     {
+                                         title:    title,
+                                         required: required
+                                     })
+      @form_object  = @form_builder.build
+      self.form     = @form_object
+    end
+
+    ## XLFormDescriptorDelegate
+    def formRowDescriptorValueHasChanged(row, oldValue: old_value, newValue: new_value)
+      super
+      rowDescriptor.value = values
+    end
+  end
+end

metadata

@@ -0,0 +1,111 @@
+--- !ruby/object:Gem::Specification
+name: ProMotion-XLForm
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Benjamin Michotte
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2015-07-23 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: ProMotion
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: motion-cocoapods
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.4'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.4'
+- !ruby/object:Gem::Dependency
+  name: motion-redgreen
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Adds XLForm screen support to ProMotion.
+email:
+- bmichotte@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- README.md
+- lib/ProMotion-XLForm.rb
+- lib/ProMotion/XLForm/cells/xl_form_image_selector_cell.rb
+- lib/ProMotion/XLForm/value_transformer.rb
+- lib/ProMotion/XLForm/xl_form.rb
+- lib/ProMotion/XLForm/xl_form_class_methods.rb
+- lib/ProMotion/XLForm/xl_form_module.rb
+- lib/ProMotion/XLForm/xl_form_patch.rb
+- lib/ProMotion/XLForm/xl_form_screen.rb
+- lib/ProMotion/XLForm/xl_form_view_controller.rb
+- lib/ProMotion/XLForm/xl_sub_form_screen.rb
+homepage: https://github.com/bmichotte/ProMotion-XLForm
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.2.3
+signing_key: 
+specification_version: 4
+summary: Adds PM::XLFormScreen support to ProMotion, similar to ProMotion-form.
+test_files: []