simple-form-builder 0.0.2.rails3

data/README.md

@@ -0,0 +1 @@
+Not ready for prime time.

data/lib/simple_form_builder.rb

@@ -0,0 +1,2 @@
+require 'simple_form_builder/form_helper'
+ActionView::Base.send :include, SimpleFormBuilder::FormHelper

data/lib/simple_form_builder/form_builder.rb

@@ -0,0 +1,249 @@
+module SimpleFormBuilder
+  class FormBuilder < ActionView::Helpers::FormBuilder
+
+    SFBOptions   = %w(wrapper_el no_colon label_text label_class label img input_val hint).collect { |o| o.to_sym }
+    InputOptions = %w(required checked rows type).collect { |o| o.to_sym }
+
+    def initialize(*args)
+      @tab_index = 0
+      super
+    end
+
+    def error_messages
+      if @object.errors.any?
+        @template.content_tag(:div, 
+          @template.content_tag(:ul,
+            @object.errors.full_messages.collect do |msg|
+              @template.content_tag(:li, msg)
+            end.join("\n").html_safe
+           ),
+          :class => "errors"
+        )
+      end
+    end
+
+    def date_select(method, options={})
+      sfb_options = extract_sfb_options(options)
+      list_item(label(method, sfb_options, options) + super, sfb_options, options.merge(:class => "dates"))
+    end
+
+    def time_select(method, options={})
+      sfb_options = extract_sfb_options(options)
+      list_item(label(method, sfb_options, options) + super, sfb_options, options.merge(:class => "dates"))
+    end
+
+    def text_field(method, options={})
+      sfb_options = extract_sfb_options(options)
+      labelled_field(method, sfb_options, options, super)
+    end
+
+    def password_field(method, options={})
+      sfb_options = extract_sfb_options(options)
+      labelled_field(method, sfb_options, options, super)
+    end
+
+    def text_area(method, options={})
+      sfb_options = extract_sfb_options(options)
+      labelled_field(method, sfb_options, options, super)
+    end
+
+    def check_box(method, options={}, checked_value="1", unchecked_value="0")
+      sfb_options = extract_sfb_options(options)
+
+      options[:class] = "checkbox"
+
+      list_item(super + label(method, sfb_options, options.merge(:no_colon => true)), sfb_options, options)
+    end
+
+    def radio_button(method, tag_value, options={})
+      sfb_options = extract_sfb_options(options)
+      label_text = sfb_options.delete(:label_text) || tag_value
+      sfb_options[:input_val] = tag_value
+      super + radio_label(method, label_text, sfb_options, options)
+    end
+
+    def select(method, choices, options={}, html_options={})
+      sfb_options = extract_sfb_options(options)
+      labelled_field(method, sfb_options, options, super)
+    end
+
+    def collection_select(method, collection, value_method=:id, text_method=:name, options={}, html_options={})
+      sfb_options = extract_sfb_options(options)
+      list_item(label(method, sfb_options, options) + super, sfb_options, options)
+    end
+
+    def country_select(method, priority_countries=nil, options={}, html_options={})
+      sfb_options = extract_sfb_options(options)
+      labelled_field(method, sfb_options, options, super)
+    end
+
+    def time_zone_select(method, priority_zones=nil, options={}, html_options={})
+      sfb_options = extract_sfb_options(options)
+      labelled_field(method, sfb_options, options, super)
+    end
+
+    def file_field(method, options={})
+      sfb_options = extract_sfb_options(options)
+      labelled_field(method, sfb_options, options, super)
+    end
+
+    def title(text)
+      @template.content_tag(:h3, text)
+    end
+    
+    def hint(text)
+      @template.content_tag(:p, text)
+    end
+
+    def fieldset(options={}, &block)
+      sfb_options = extract_sfb_options(options)
+      contents = capture(&block)
+      @template.content_tag(
+        :fieldset,
+        @template.content_tag(:ol, contents),
+        options
+      )
+    end
+
+    def buttons(&block)
+      contents = capture(&block)
+      @template.content_tag(
+        :fieldset,
+        @template.content_tag(:ol, contents)
+      )
+    end
+
+    def button(options={})
+      sfb_options = extract_sfb_options(options)
+      prefix = @object.respond_to?(:new_record?) && @object.new_record? ? "Create" : "Save"
+      label = sfb_options.delete(:label) || "#{prefix @object_name.humanize}"
+      button_content = sfb_options.delete(:img) ? @template.content_tag(:img, nil, :src => button_content, :alt => label) + label : label
+      list_item(@template.content_tag(:button, button_content, options.merge(:type => "submit")), sfb_options, options.merge(:class => "button"))
+    end
+    
+    def inner_fieldset(legend=nil, &block)
+      contents = capture(&block)
+      @template.content_tag(
+        :li,
+        @template.content_tag(
+          :fieldset,
+          @template.content_tag(:h3, "#{legend}:") +
+          @template.content_tag(:ol, contents)
+        )
+      )
+    end
+
+    def submit(value="Save Changes", options={})
+      sfb_options = extract_sfb_options(options)
+      @template.content_tag(:fieldset, super, :class => "button")
+    end
+
+    def fieldgroup(options={}, &block)
+      sfb_options = extract_sfb_options(options)
+      contents = capture(&block)
+      @already_grouping = true
+      @template.content_tag(
+        :li,
+        contents,
+        options
+      )
+      @already_grouping = false
+    end
+
+    def labelled_field(method, sfb_options, options, markup)
+      if @already_grouping
+        markup + label(method, sfb_options, options)
+      else
+        list_item(label(method, sfb_options, options) + markup, sfb_options, options)
+      end
+    end
+
+    def reversed_labelled_field(method, sfb_options, options, markup)
+      if @already_grouping
+        markup + label(method, sfb_options, options)
+      else
+        list_item(markup + label(method, sfb_options, options), sfb_options, options)
+      end
+    end
+    
+    def simple_fields_for(record_or_name_or_array, *args, &proc)
+      options = args.extract_options!
+      fields_for(record_or_name_or_array, *(args << options.merge(:builder => self.class)), &proc)
+    end  
+
+    private
+    def extract_sfb_options(options={})
+      SFBOptions.inject({}) do |h, k|
+        h[k] = options.delete(k)
+        h
+      end
+    end
+
+    def strip_input_options(options={})
+      options.tap do |o|
+        InputOptions.each do |k|
+          o.delete(k)
+        end
+      end
+    end
+
+    def capture(&block)
+      if block_given?
+        contents = if @template.respond_to?(:is_haml?) && @template.is_haml?
+          @template.capture_haml(&block)
+        else
+          @template.capture(&block)
+        end
+      end
+    end
+
+    def list_item(markup, sfb_options, options={})
+      container_element = sfb_options[:wrapper_el] || :li
+      @template.content_tag(container_element, markup, strip_input_options(options))
+    end
+
+    def label(method, sfb_options, options={})
+      text = sfb_options[:label] || (@already_grouping ? method.to_s.titleize.upcase : method.to_s.titleize)
+      text += ":" unless sfb_options[:no_colon]
+
+      hint = sfb_options[:hint]
+
+      text = text + " <span class='hint'>#{hint}</span>" if hint
+
+      dom_class = sfb_options[:label_class] || method
+
+      ActionView::Helpers::InstanceTag.new(
+        object_name, method, self, object
+      ).to_label_tag(text.html_safe, :class => dom_class)
+    end
+
+    def radio_label(method, value, sfb_options, options={})
+      for_val = sfb_options[:input_val] || value
+      @template.content_tag :label,
+        value.humanize,
+        options.merge(:for => radio_button_id(method, for_val, strip_input_options(options)))
+    end
+
+    def radio_button_id(method, value, options)
+      pretty_value = value.to_s.gsub(/\s/, "_").gsub(/\W/, "").downcase
+
+      options[:id] || defined?(@auto_index) ?
+        "#{object_name}_#{@auto_index}_#{method}_#{pretty_value}" :
+        "#{object_name}_#{method}_#{pretty_value}"
+    end
+    
+    def cancel_link(options_or_url)
+      if options_or_url.is_a? Hash
+        cancel_url   = options_or_url.delete(:url)
+        dom_class    = options_or_url.delete(:class)
+        cancel_label = options_or_url.delete(:label)
+      else
+        cancel_url   = options_or_url 
+        dom_class    = nil
+        cancel_label = nil
+      end
+      @template.link_to cancel_label || "Cancel", cancel_url || :back, :class => "cancel #{dom_class}"
+    end
+  end
+    
+end

data/lib/simple_form_builder/form_helper.rb

@@ -0,0 +1,20 @@
+require 'simple_form_builder/form_builder'
+
+module SimpleFormBuilder
+  module FormHelper
+    def simple_form_for(record_or_name_or_array, *args, &proc)
+      options = args.extract_options!
+      # Remove any nils if we received an array, this allows for common forms to be built
+      # that can be used for both edit and new actions but that don't require the edit action
+      # to be nested within a parent resource
+      record_or_name_or_array.reject! {|a| a.nil? } if record_or_name_or_array.is_a? Array 
+      # Now build the form
+      form_for(record_or_name_or_array, *(args << options.merge(:builder => SimpleFormBuilder::FormBuilder)), &proc)
+    end
+    
+    def simple_fields_for(record_or_name_or_array, *args, &proc)
+      options = args.extract_options!
+      fields_for(record_or_name_or_array, *(args << options.merge(:builder => SimpleFormBuilder::FormBuilder)), &proc)
+    end
+  end
+end

data/lib/simple_form_builder/version.rb

@@ -0,0 +1,3 @@
+module SimpleFormBuilder
+  VERSION = '0.0.2.rails3'
+end

metadata

@@ -0,0 +1,78 @@
+--- !ruby/object:Gem::Specification 
+name: simple-form-builder
+version: !ruby/object:Gem::Version 
+  hash: 708262389
+  prerelease: 6
+  segments: 
+  - 0
+  - 0
+  - 2
+  - rails
+  - 3
+  version: 0.0.2.rails3
+platform: ruby
+authors: 
+- Ben Askins
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-01-13 00:00:00 +11:00
+default_executable: 
+dependencies: []
+
+description: Extends ActionView::Helpers::FormBuilder with simple, best practices markup.
+email: 
+- ben.askins@plus2.com.au
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- lib/simple_form_builder/form_builder.rb
+- lib/simple_form_builder/form_helper.rb
+- lib/simple_form_builder/version.rb
+- lib/simple_form_builder.rb
+- CHANGELOG.md
+- README.md
+- ROADMAP.md
+has_rdoc: true
+homepage: http://github.com/plustwo/simple-form-builder
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 23
+      segments: 
+      - 1
+      - 3
+      - 6
+      version: 1.3.6
+requirements: []
+
+rubyforge_project: simple-form-builder
+rubygems_version: 1.4.2
+signing_key: 
+specification_version: 3
+summary: A best-practice FormBuilder
+test_files: []
+