motion-form 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 62b070da82951513aecbfda093cfbc243beb1768
+  data.tar.gz: 24a8bea72a87cfdeb04d08d121f0fe63ccb6be1a
+SHA512:
+  metadata.gz: 46285b557f7bbb68a6ded12d7e139ec8d8293330fb68f96614854b7cf073dfd5d83400293d1d8209618925fc070b53cbc8141e007602938be1b60d2cfaa9db89
+  data.tar.gz: b9d211dd2c64ff3054a7425b521f4a54205431f8983b5a170b4ca723ecdc7505d2bc9a540f28a4dd6dc2b401a054fad9d68551600d79dd6d3cce5aeec039223b

data/README.md

@@ -0,0 +1,59 @@
+# 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.
+
+![Screenshot](https://github.com/dblandin/motion-form/blob/master/img/screenshot.png?raw=true)
+
+## Usage
+
+```ruby
+form = MotionForm.form_for(view) do |f|
+  f.section 'Profile' do |section|
+    section.input :name,      icon: :contact
+    section.input :username,  icon: :user
+    section.input :pinterest, icon: :pinterest
+    section.input :twitter,   icon: :twitter
+    section.input :website,   icon: :website
+    section.input :bio,       icon: :info
+  end
+
+  f.section 'Account' do |section|
+    section.button :change_email, icon: :email, action: push_email_controller
+    section.button :change_password, icon: :lock, action: push_password_controller
+  end
+end
+
+def push_email_controller
+  # push controller
+end
+
+def push_password_controller
+  # push controller
+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

data/lib/motion-form.rb

@@ -0,0 +1,8 @@
+unless defined?(Motion::Project::Config)
+  raise "This file must be required within a RubyMotion project Rakefile."
+end
+
+lib_dir_path = File.dirname(File.expand_path(__FILE__))
+Motion::Project::App.setup do |app|
+  app.files.unshift(Dir.glob(File.join(lib_dir_path, "project/**/*.rb")))
+end

data/lib/project/cells/base_cell.rb

@@ -0,0 +1,31 @@
+class BaseCell < UITableViewCell
+  attr_accessor :key
+
+  class << self
+    def has_value?
+      false
+    end
+  end
+
+  def initWithStyle(style, reuseIdentifier: reuse_identifier)
+    super.tap do |cell|
+      cell.selectionStyle = UITableViewCellSelectionStyleNone
+      cell.contentView.addSubview(text_field)
+      cell.selectedBackgroundView = selected_background_view
+    end
+  end
+
+  def selected_background_view
+    UIView.alloc.initWithFrame(bounds).tap do |view|
+      view.backgroundColor = 'FFCDCB'.to_color
+    end
+  end
+
+  def notification_center
+    NSNotificationCenter.defaultCenter
+  end
+
+  def post(notification)
+    notification_center.postNotificationName(notification, object: self, userInfo: notification_payload)
+  end
+end

data/lib/project/cells/button_cell.rb

@@ -0,0 +1,52 @@
+class ButtonCell < TextFieldCell
+  IDENTIFIER = 'ButtonCell'
+
+  class << self
+    def has_value?
+      false
+    end
+  end
+
+  def initWithStyle(style, reuseIdentifier: reuse_identifier)
+    super.tap do |cell|
+      cell.selectionStyle     = UITableViewCellSelectionStyleGray
+      cell.text_field.enabled = false
+
+      cell.add_right_view
+      cell.add_tap_recognizer
+    end
+  end
+
+  def add_tap_recognizer
+    addGestureRecognizer(tap_recognizer)
+  end
+
+  def tap_recognizer
+    UITapGestureRecognizer.alloc.initWithTarget(self, action: 'tapped:')
+  end
+
+  def tapped(recognizer)
+    post('FormCellWasTapped')
+  end
+
+  def add_right_view
+    text_field.rightView     = right_view
+    text_field.rightViewMode = UITextFieldViewModeAlways
+  end
+
+  def right_view
+    @right_view ||= IconView.alloc.init.tap do |icon|
+      icon.name = :forward_arrow
+    end
+  end
+
+  def layoutSubviews
+    super
+
+    right_view.frame = [[size.width - 56, 0], [36, 43]]
+  end
+
+  def notification_payload
+    { key: key }
+  end
+end

data/lib/project/cells/text_field_cell.rb

@@ -0,0 +1,63 @@
+class TextFieldCell < BaseCell
+  IDENTIFIER = 'TextFieldCell'
+
+  class << self
+    def has_value?
+      true
+    end
+  end
+
+  def label=(label)
+    text_field.placeholder = label
+  end
+
+  def icon=(icon)
+    left_view.name = icon
+  end
+
+  def text_field
+    @text_field ||= UITextField.alloc.init.tap do |field|
+      field.autocorrectionType       = UITextAutocorrectionTypeNo
+      field.autoresizingMask         = UIViewAutoresizingFlexibleWidth | UIViewAutoresizingFlexibleHeight
+      field.backgroundColor          = UIColor.clearColor
+      field.clearButtonMode          = UITextFieldViewModeWhileEditing
+      field.contentVerticalAlignment = UIControlContentVerticalAlignmentCenter
+      field.leftView                 = left_view
+      field.leftViewMode             = UITextFieldViewModeAlways
+      field.textColor                = UIColor.grayColor
+
+      field.delegate = self
+    end
+  end
+
+  def left_view
+    @left_view ||= IconView.alloc.init
+  end
+
+  def value
+    text_field.text
+  end
+
+  def layoutSubviews
+    text_field.frame = [[10, 0], [300, 43]]
+    left_view.frame  = [[0, 0], [36, 43]]
+  end
+
+  def textFieldDidBeginEditing(text_field)
+    post('FormCellDidBeginEditing')
+  end
+
+  def textFieldDidEndEditing(text_field)
+    post('FormCellDidEndEditing')
+  end
+
+  def textFieldShouldReturn(text_field)
+    text_field.resignFirstResponder
+
+    true
+  end
+
+  def notification_payload
+    { key: key, value: value, text_field: text_field }
+  end
+end

data/lib/project/controllers/form_controller.rb

@@ -0,0 +1,17 @@
+module MotionForm
+  class FormController < UIViewController
+    attr_reader :form
+
+    def viewDidLoad
+      super
+
+      setup_form
+    end
+
+    private
+
+    def setup_form
+      @form = MotionForm.form_for(view)
+    end
+  end
+end

data/lib/project/form/base.rb

@@ -0,0 +1,123 @@
+module MotionForm
+  class Base < UITableView
+    attr_reader :keyboard_avoiding_delegate
+
+    def init
+      initWithFrame(frame, style: UITableViewStylePlain).tap do |f|
+        f.register_cells
+        f.separatorStyle = UITableViewCellSeparatorStyleNone
+
+        f.dataSource = self
+        f.delegate   = self
+
+        @keyboard_avoiding_delegate = Motion::KeyboardAvoiding.new(f)
+        listen
+      end
+    end
+
+    def listen
+      observers << notification_center.addObserver(self, selector: 'did_begin_editing:', name: 'FormCellDidBeginEditing', object: nil)
+      observers << notification_center.addObserver(self, selector: 'did_end_editing:', name: 'FormCellDidEndEditing', object: nil)
+    end
+
+    def did_begin_editing(notification)
+      unless window.nil?
+        keyboard_avoiding_delegate.textFieldDidBeginEditing(notification.userInfo[:text_field])
+      end
+    end
+
+    def did_end_editing(notification)
+      unless window.nil?
+        keyboard_avoiding_delegate.textFieldDidEndEditing(notification.userInfo[:text_field])
+      end
+    end
+
+    def observers
+      @observers ||= []
+    end
+
+    def notification_center
+      NSNotificationCenter.defaultCenter
+    end
+
+    def section(title = '')
+      build_section(title).tap do |section|
+        yield section
+      end
+    end
+
+    def build_section(title)
+      MotionForm::Section.new(title).tap do |section|
+        sections << section
+      end
+    end
+
+    def sections
+      @sections ||= []
+    end
+
+    def register_cells
+      MotionForm.registered_cells.each do |klass|
+        registerClass(klass, forCellReuseIdentifier: klass::IDENTIFIER)
+      end
+    end
+
+    def numberOfSectionsInTableView(table_view)
+      sections.count
+    end
+
+    def tableView(table_view, numberOfRowsInSection: section_index)
+      sections[section_index].rows.count
+    end
+
+    def tableView(table_view, didSelectRowAtIndexPath: index_path)
+      section = sections[index_path.section]
+      row     = section.rows[index_path.row]
+    end
+
+    def tableView(table_view, viewForHeaderInSection: section)
+      unless sections[section].title.blank?
+        SectionHeaderView.alloc.initWithFrame([[0, 0], [size.width, 44.0]]).tap do |header|
+          header.text = table_view.tableView(table_view, titleForHeaderInSection: section)
+        end
+      end
+    end
+
+    def tableView(table_view, titleForHeaderInSection: section)
+      sections[section].title
+    end
+
+    def tableView(table_view, heightForHeaderInSection: section)
+      if sections[section].title.blank?
+        0.0
+      else
+        44.0
+      end
+    end
+
+    def rows
+      sections.map(&:rows).flatten
+    end
+
+    def tableView(table_view, cellForRowAtIndexPath: index_path)
+      section = sections[index_path.section]
+      row     = section.rows[index_path.row]
+
+      table_view.dequeueReusableCellWithIdentifier(row.cell_identifier).tap do |cell|
+        row.update_cell(cell)
+      end
+    end
+
+    def render
+      Hash[render_values]
+    end
+
+    def render_values
+      value_rows.map { |row| [row.key, row.value] }
+    end
+
+    def value_rows
+      rows.select { |row| row.has_value? }
+    end
+  end
+end

data/lib/project/keyboard_avoiding_delegate.rb

@@ -0,0 +1,113 @@
+class KeyboardAvoidingDelegate
+  KEYBOARD_ANIMATION_DURATION = 0.3
+  MINIMUM_SCROLL_FRACTION     = 0.2
+  MAXIMUM_SCROLL_FRACTION     = 0.8
+  PORTRAIT_KEYBOARD_HEIGHT    = 216.0
+  LANDSCAPE_KEYBOARD_HEIGHT   = 162.0
+
+  attr_accessor :view, :animated_distance, :active_text_field
+
+  def initialize(view)
+    self.view = view
+
+    add_tap_recognizer
+    listen_to_notifications
+  end
+
+  def listen_to_notifications
+    observers << notification_center.addObserver(self, selector: 'did_begin_editing:', name: 'FormCellDidBeginEditing', object: nil)
+    observers << notification_center.addObserver(self, selector: 'did_end_editing:', name: 'FormCellDidEndEditing', object: nil)
+  end
+
+  def notification_center
+    NSNotificationCenter.defaultCenter
+  end
+
+  def did_begin_editing(notification)
+    textFieldDidBeginEditing(notification.userInfo[:text_field])
+  end
+
+  def did_end_editing(notification)
+    textFieldDidEndEditing(notification.userInfo[:text_field])
+  end
+
+  def observers
+    @observers ||= []
+  end
+
+  def remove_all_observers
+    observers.each do |observer|
+      notification_center.removeObserver(observer)
+    end
+  end
+
+  def dealloc
+    remove_all_observers
+  end
+
+  def add_tap_recognizer
+    view.addGestureRecognizer(tap_recognizer)
+  end
+
+  def tap_recognizer
+    UITapGestureRecognizer.alloc.initWithTarget(self, action: 'dismiss_keyboard')
+  end
+
+  def dismiss_keyboard
+    active_text_field.resignFirstResponder if active_text_field
+  end
+
+  def textFieldDidBeginEditing(text_field)
+    self.active_text_field = text_field
+
+    text_field_rect = view.window.convertRect(text_field.bounds, fromView: text_field)
+    view_rect       = view.window.convertRect(view.bounds, fromView: view)
+    midline         = text_field_rect.origin.y + 0.5 * text_field_rect.size.height
+    numerator       = midline - view_rect.origin.y - MINIMUM_SCROLL_FRACTION * view_rect.size.height
+    denominator     = (MAXIMUM_SCROLL_FRACTION - MINIMUM_SCROLL_FRACTION) * view_rect.size.height
+    height_fraction = numerator / denominator
+
+    if height_fraction < 0.0
+      height_fraction = 0.0
+    elsif height_fraction > 1.0
+      height_fraction = 1.0
+    end
+
+    orientation = UIApplication.sharedApplication.statusBarOrientation
+    if orientation == UIInterfaceOrientationPortrait || orientation == UIInterfaceOrientationPortraitUpsideDown
+      self.animated_distance = (PORTRAIT_KEYBOARD_HEIGHT * height_fraction).floor
+    else
+      self.animated_distance = (LANDSCAPE_KEYBOARD_HEIGHT * height_fraction).floor
+    end
+
+    view_frame = view.frame
+    view_frame.origin.y -= animated_distance
+
+    UIView.beginAnimations(nil, context: nil)
+    UIView.setAnimationBeginsFromCurrentState(true)
+    UIView.setAnimationDuration(KEYBOARD_ANIMATION_DURATION)
+
+    view.setFrame(view_frame)
+
+    UIView.commitAnimations
+  end
+
+  def textFieldDidEndEditing(text_field)
+    view_frame = view.frame
+    view_frame.origin.y += animated_distance
+
+    UIView.beginAnimations(nil, context: nil)
+    UIView.setAnimationBeginsFromCurrentState(true)
+    UIView.setAnimationDuration(KEYBOARD_ANIMATION_DURATION)
+
+    view.setFrame(view_frame)
+
+    UIView.commitAnimations
+  end
+
+  def textFieldShouldReturn(text_field)
+    text_field.resignFirstResponder
+
+    true
+  end
+end

data/lib/project/motion-form.rb

@@ -0,0 +1,32 @@
+module MotionForm
+  class << self
+    attr_accessor :icon_font
+
+    def config
+      yield self
+    end
+
+    def form_for(view)
+      MotionForm::Base.new.tap do |form|
+
+        yield form if block_given?
+
+        form.frame = view.bounds
+
+        view.addSubview(form)
+      end
+    end
+
+    def register_cell(cell)
+      registered_cells << cell
+    end
+
+    def registered_cells
+      @registered_cells ||= included_cells
+    end
+
+    def included_cells
+      [TextFieldCell, ButtonCell]
+    end
+  end
+end

data/lib/project/rows/base_row.rb

@@ -0,0 +1,43 @@
+class BaseRow
+  attr_reader :icon, :key, :options
+
+  def initialize(key, options)
+    @key     = key
+    @options = options
+
+    @icon  = options.fetch(:icon, nil)
+    @value = options.fetch(:value, nil)
+  end
+
+  def observers
+    @observers ||= []
+  end
+
+  def remove_all_observers
+    observers.each do |observer|
+      notification_center.removeObserver(observer)
+    end
+  end
+
+  def notification_center
+    NSNotificationCenter.defaultCenter
+  end
+
+  def cell_identifier
+    cell_type::IDENTIFIER
+  end
+
+  def has_value?
+    cell_type.has_value?
+  end
+
+  def update_cell(cell)
+    cell.key   = key
+    cell.label = name
+    cell.icon  = icon
+  end
+
+  def name
+    key.to_s.titleize
+  end
+end

data/lib/project/rows/button_row.rb

@@ -0,0 +1,27 @@
+class ButtonRow < TextFieldRow
+  attr_reader :on_tap_callback
+
+  def initialize(key, options)
+    super
+
+    @on_tap_callback = options.fetch(:action, lambda {})
+  end
+
+  def cell_type
+    ButtonCell
+  end
+
+  def accessory
+    options.fetch(:accessory, nil)
+  end
+
+  def listen
+    observers << notification_center.addObserver(self, selector: 'tapped:', name: 'FormCellWasTapped', object: nil)
+  end
+
+  def tapped(notification)
+    if notification.userInfo[:key] == key
+      on_tap_callback.call
+    end
+  end
+end

data/lib/project/rows/text_field_row.rb

@@ -0,0 +1,25 @@
+class TextFieldRow < BaseRow
+  attr_accessor :value
+
+  def initialize(key, options)
+    super
+
+    listen
+  end
+
+  def listen
+    observers << notification_center.addObserver(self, selector: 'did_end_editing:', name: 'FormCellDidEndEditing', object: nil)
+  end
+
+  def did_end_editing(notification)
+    self.value = notification.userInfo[:value] if notification.userInfo[:key] == key
+  end
+
+  def textFieldDidEndEditing(text_field)
+    self.value = text_field.text
+  end
+
+  def cell_type
+    TextFieldCell
+  end
+end

data/lib/project/section/section.rb

@@ -0,0 +1,21 @@
+class MotionForm
+  class Section
+    attr_reader :title
+
+    def initialize(title = '')
+      @title = title
+    end
+
+    def input(key, options = {})
+      rows << TextFieldRow.new(key, options)
+    end
+
+    def button(key, options = {})
+      rows << ButtonRow.new(key, options)
+    end
+
+    def rows
+      @rows ||= []
+    end
+  end
+end

data/lib/project/string.rb

@@ -0,0 +1,9 @@
+class String
+  def titleize
+    gsub('_', ' ').split(/(\W)/).map(&:capitalize).join
+  end
+
+  def blank?
+    self == ''
+  end
+end

data/lib/project/views/icon_view.rb

@@ -0,0 +1,38 @@
+class IconView < UILabel
+  attr_reader :name
+
+  def init
+    super.tap do |view|
+      view.font            = MotionForm.icon_font
+      view.backgroundColor = UIColor.clearColor
+      view.textColor       = UIColor.grayColor
+      view.textAlignment   = NSTextAlignmentCenter
+    end
+  end
+
+  def name=(name)
+    @name = name
+
+    self.text = hex
+  end
+
+  def hex
+    unicode ? unicode.hex.chr(Encoding::UTF_8) : ''
+  end
+
+  def unicode
+    icon_mappings[name]
+  end
+
+  def icon_mappings
+    @_icon_mappings ||= BW::JSON.parse(json_data.to_str)
+  end
+
+  def json_data
+    NSData.dataWithContentsOfFile(json_path)
+  end
+
+  def json_path
+    NSBundle.mainBundle.pathForResource('font_icons', ofType: 'json')
+  end
+end

data/lib/project/views/padded_label.rb

@@ -0,0 +1,17 @@
+class PaddedLabel < UILabel
+  def drawTextInRect(rect)
+    insets = UIEdgeInsets.new(0, padding, 0, padding)
+
+    padded_rect = UIEdgeInsetsInsetRect(rect, insets)
+
+    super(padded_rect)
+  end
+
+  def padding=(padding)
+    @padding = padding
+  end
+
+  def padding
+    @padding || 0
+  end
+end

data/lib/project/views/section_header_view.rb

@@ -0,0 +1,21 @@
+class SectionHeaderView < UIView
+  def initWithFrame(frame)
+    super.tap do |view|
+      view.addSubview(section_title)
+    end
+  end
+
+  def text=(text)
+    section_title.text = text
+  end
+
+  def section_title
+    @section_title ||= PaddedLabel.alloc.initWithFrame(bounds).tap do |label|
+      label.padding = 10
+      label.backgroundColor = UIColor.redColor
+      label.adjustsFontSizeToFitWidth = true
+      label.textColor = UIColor.whiteColor
+      label.font = UIFont.fontWithName('Helvetica Neue', size: 20.0)
+    end
+  end
+end

metadata

@@ -0,0 +1,89 @@
+--- !ruby/object:Gem::Specification
+name: motion-form
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Devon Blandin
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-07-29 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: motion-keyboard-avoiding
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !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: RubyMotion Forms made easy.
+email:
+- dblandin@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- README.md
+- lib/motion-form.rb
+- lib/project/cells/base_cell.rb
+- lib/project/cells/button_cell.rb
+- lib/project/cells/text_field_cell.rb
+- lib/project/controllers/form_controller.rb
+- lib/project/form/base.rb
+- lib/project/keyboard_avoiding_delegate.rb
+- lib/project/motion-form.rb
+- lib/project/rows/base_row.rb
+- lib/project/rows/button_row.rb
+- lib/project/rows/text_field_row.rb
+- lib/project/section/section.rb
+- lib/project/string.rb
+- lib/project/views/icon_view.rb
+- lib/project/views/padded_label.rb
+- lib/project/views/section_header_view.rb
+homepage: https://github.com/dblandin/motion-form
+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.0.0
+signing_key: 
+specification_version: 4
+summary: Simple DSL for RubyMotion form creation
+test_files: []