bootstrap_form_helper 2.0.2.0.beta1

data/lib/bootstrap_form_helper/form_builder.rb

@@ -0,0 +1,183 @@
+require 'action_view/helpers/form_helper'
+require 'bootstrap_form_helper'
+
+class BootstrapFormHelper::FormBuilder < ActionView::Helpers::FormBuilder
+
+  INPUTS = (%w(select collection_select grouped_collection_select time_zone_select).map(&:to_sym) +
+            field_helpers -
+            %w(label check_box radio_button fields_for hidden_field).map(&:to_sym))
+
+  ##
+  # Wraps the contents of the block passed to the method in a +fieldset+ tag with
+  # a optional +legend+ text.
+  #
+  def fieldset(legend = nil, options = {})
+    @template.content_tag(:fieldset, options) do
+      @template.concat @template.content_tag(:legend, legend) unless legend.nil?
+      yield
+    end
+  end
+
+  ##
+  # Wraps action buttons into their own styled container.
+  #
+  def actions(&block)
+    @template.content_tag(:div, class: 'form-actions', &block)
+  end
+
+  INPUTS.each do |input|
+    define_method input do |attribute, *args, &block|
+      options = args.extract_options!
+      text    = args.any? ? args.shift : ''
+
+      label attribute, text do |builder|
+        builder.send input, attribute, *(args << options), &block
+      end
+    end
+  end
+
+  ##
+  # Attaches a label to the inputs rendered inside of the block passed to it.
+  # Associates the label with the input for the +attribute+ given. If +text+
+  # is passed, uses that as the text for the label; otherwise humanizes the
+  # +attribute+ name.
+  #
+  def label(attribute, text = '', options = {}, &block)
+    text, attribute = attribute, nil if attribute.kind_of? String
+
+    options = { class: 'control-label' }.merge(options)
+    id      = wrapper_id      attribute, 'control_group'
+    classes = wrapper_classes attribute, 'control-group'
+    fields_options = options.merge(builder: BootstrapFormHelper::FormControls)
+
+    @template.content_tag(:div, id: id, class: classes) do
+      @template.concat case
+        when attribute && text then super(attribute, text, options, &nil)
+        when attribute         then super(attribute, nil,  options, &nil)
+        when text              then @template.label_tag(nil, text, options, &nil)
+      end
+
+      @template.concat @template.content_tag(:div, class: 'controls') {
+        @template.fields_for object_name, object, fields_options, &block
+        }
+    end
+  end
+
+  ##
+  # Renders a button with default classes to style it as a form button.
+  #
+  def button(value = nil, options = {})
+    super value, { type: 'button', class: 'btn' }.merge(options)
+  end
+
+  ##
+  # Renders a submit tag with default classes to style it as a primary form
+  # button.
+  #
+  def submit(value = nil, options = {})
+    button value, { type: 'submit', class: 'btn btn-primary' }.merge(options)
+  end
+
+  private
+
+  def errors_on?(attribute)
+    object.errors[attribute].present? if object.respond_to?(:errors)
+  end
+
+  def wrapper_id(attribute, suffix = nil)
+    [
+     bootstrap_object_name + object_index,
+     attribute_name(attribute),
+     suffix,
+    ].compact.join('_') if attribute
+  end
+
+  def wrapper_classes(attribute, *classes)
+    classes.push 'error' if attribute and errors_on? attribute
+    classes.join(' ')
+  end
+
+  def attribute_name(attribute)
+    attribute.to_s.sub(/[\?\/\-]$/, '')
+  end
+
+  def bootstrap_object_name
+    object_name.to_s.gsub(/\]\[|[^-a-zA-Z0-9:.]/, '_').sub(/_$/, '')
+  end
+
+  def object_index
+    case
+      when options.has_key?(:index) then options[:index]
+      when defined?(@auto_index)    then @auto_index
+      else                               nil
+    end.to_s
+  end
+end
+
+class BootstrapFormHelper::FormControls < ActionView::Helpers::FormBuilder
+  BootstrapFormHelper::FormBuilder::INPUTS.each do |input|
+    define_method input do |attribute, *args, &block|
+      options       = args.extract_options!
+      input_prepend = options.delete :input_prepend
+      input_append  = options.delete :input_append
+
+      @template.capture do
+        if input_prepend.present? || input_append.present?
+          classes = []
+          classes << 'input-prepend' if input_prepend.present?
+          classes << 'input-append' if input_append.present?
+          classes = classes.join(' ')
+          @template.concat @template.content_tag(:div, class: classes) {
+            if input_prepend.present?
+              @template.concat @template.content_tag(:span, input_prepend, class: 'add-on')
+            end
+            @template.concat super(attribute, *(args << options))
+            if input_append.present?
+              @template.concat @template.content_tag(:span, input_append, class: 'add-on')
+            end
+          }
+        else
+          @template.concat super(attribute, *(args << options))
+        end
+        @template.concat error_span(attribute) if errors_on? attribute
+        block.call if block.present?
+      end
+    end
+  end
+
+  def check_box(attribute, text, options = {}, checked_value = 1, unchecked_value = 0)
+    klasses = 'checkbox'
+    klasses += ' inline' if options.delete :inline
+
+    label attribute, class: klasses do
+      template.concat super(attribute, options, checked_value, unchecked_value)
+      template.concat text
+      yield if block_given?
+    end
+  end
+
+  def radio_button(attribute, value, text = nil, options = {})
+    klasses = 'radio'
+    klasses += ' inline' if options.delete :inline
+
+    label attribute, class: klasses do
+      template.concat super(attribute, value, options)
+      template.concat text || value.to_s.humanize.titleize
+      yield if block_given?
+    end
+  end
+
+  private
+
+  def error_span(attribute)
+    @template.content_tag :span, errors_for(attribute), class: 'help-inline'
+  end
+
+  def errors_for(attribute)
+    object.errors[attribute].try(:join, ', ')
+  end
+
+  def errors_on?(attribute)
+    object.errors[attribute].present? if object.respond_to?(:errors)
+  end
+end

data/lib/bootstrap_form_helper/form_helper.rb

@@ -0,0 +1,32 @@
+require 'active_support/core_ext/array/extract_options'
+require 'bootstrap_form_helper'
+
+module BootstrapFormHelper::FormHelper
+  def bootstrap_form_for(*args, &proc)
+    options = args.extract_options!
+    options.merge!(builder: BootstrapFormHelper::FormBuilder)
+    set_noop_field_error_proc do
+      form_for(*(args << options), &proc)
+    end
+  end
+
+  def bootstrap_fields_for(*args, &proc)
+    options = args.extract_options!
+    options.merge!(builder: BootstrapFormHelper::FormBuilder)
+    set_noop_field_error_proc do
+      fields_for(*(args << options), &proc)
+    end
+  end
+
+  private
+
+  NOOP_FIELD_ERROR_PROC = Proc.new { |x| x }
+
+  def set_noop_field_error_proc
+    saved = ActionView::Base.field_error_proc
+    ActionView::Base.field_error_proc = NOOP_FIELD_ERROR_PROC
+    yield
+  ensure
+    ActionView::Base.field_error_proc = saved
+  end
+end

data/lib/bootstrap_form_helper/railtie.rb

@@ -0,0 +1,9 @@
+require 'action_view'
+require 'bootstrap_form_helper'
+require 'rails/railtie'
+
+class BootstrapFormHelper::Railtie < Rails::Railtie
+  config.after_initialize do
+    ActionView::Base.send :include, BootstrapFormHelper::FormHelper
+  end
+end

data/lib/bootstrap_form_helper.rb

@@ -0,0 +1,7 @@
+module BootstrapFormHelper
+  autoload :FormBuilder, 'bootstrap_form_helper/form_builder'
+  autoload :FormHelper,  'bootstrap_form_helper/form_helper'
+  autoload :Railtie,     'bootstrap_form_helper/railtie'
+end
+
+BootstrapFormHelper::Railtie

metadata

@@ -0,0 +1,99 @@
+--- !ruby/object:Gem::Specification
+name: bootstrap_form_helper
+version: !ruby/object:Gem::Version
+  version: 2.0.2.0.beta1
+  prerelease: 8
+platform: ruby
+authors:
+- Ehren Kret
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-04-30 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: railties
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '3'
+    - - <
+      - !ruby/object:Gem::Version
+        version: '4'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '3'
+    - - <
+      - !ruby/object:Gem::Version
+        version: '4'
+- !ruby/object:Gem::Dependency
+  name: actionpack
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '3'
+    - - <
+      - !ruby/object:Gem::Version
+        version: '4'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '3'
+    - - <
+      - !ruby/object:Gem::Version
+        version: '4'
+description: ! 'A rails form helper and builder for use with Twitter''s Bootstrap.
+  It wraps
+
+  form elements with the DOM necessary to render them correctly using
+
+  Bootstrap and automatically renders validation errors using Bootstrap.
+
+'
+email: ehren.kret@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/bootstrap_form_helper.rb
+- lib/bootstrap_form_helper/form_builder.rb
+- lib/bootstrap_form_helper/form_helper.rb
+- lib/bootstrap_form_helper/railtie.rb
+homepage: https://github.com/eakret/bootstrap_form_helper
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '1.9'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>'
+    - !ruby/object:Gem::Version
+      version: 1.3.1
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.23
+signing_key: 
+specification_version: 3
+summary: Rails form helper for Twitter's Bootstrap
+test_files: []