bh 0.0.4 → 0.0.5

data/lib/bh/helpers/form/check_box_helper.rb

@@ -0,0 +1,35 @@
+require 'bh/helpers/form/base_helper'
+
+module Bh
+  module Form
+    module CheckBoxHelper
+      include BaseHelper
+
+      def check_box(method, options = {}, checked_value = '1', unchecked_value = '0')
+        block = -> { super method, options, checked_value, unchecked_value }
+        if options.delete(:inline_label) { true }
+          check_box_with_inline_label method, options, &block
+        else
+          check_box_with_block_label method, options, &block
+        end
+      end
+
+    private
+
+      def check_box_with_block_label(method, options = {}, &block)
+        append_class! options, 'form-control' unless inline_form?
+        append_class! options, 'checkbox' if horizontal_form?
+        options[:label] ||= method.to_s.humanize
+        base_field method, :checkbox, options, &block
+      end
+
+      def check_box_with_inline_label(method, options = {}, &block)
+        options.merge! offset: true, use_label: false
+        options[:label] ||= method.to_s.humanize
+        base_field method, :checkbox, options do
+          label_and_field 'checkbox', method, options, &block
+        end
+      end
+    end
+  end
+end

data/lib/bh/helpers/form/field_helper.rb

@@ -0,0 +1,15 @@
+require 'bh/helpers/form/base_helper'
+
+module Bh
+  module Form
+    module FieldHelper
+      include BaseHelper
+
+      def field(method, field_type, options = {}, &block)
+        options[:placeholder] ||= method.to_s.humanize
+        append_class! options, 'form-control'
+        base_field method, field_type, options, &block
+      end
+    end
+  end
+end

data/lib/bh/helpers/form/fields_for_helper.rb

@@ -0,0 +1,17 @@
+require 'bh/helpers/form/fieldset_helper'
+
+module Bh
+  module Form
+    module FieldsForHelper
+      include BaseHelper
+      include FieldsetHelper # for fieldset
+
+      def fields_for(record_object = nil, fields_options = {}, &block)
+        fields_options[:layout] ||= @options[:layout]
+        fields_options[:errors] ||= @options[:errors]
+        title = fields_options.delete(:title) { record_object.to_s.humanize }
+        fieldset(title) { super record_object, fields_options, &block }
+      end
+    end
+  end
+end

data/lib/bh/helpers/form/fieldset_helper.rb

@@ -0,0 +1,16 @@
+require 'bh/helpers/panel_helper'
+
+module Bh
+  module Form
+    module FieldsetHelper
+      include BaseHelper
+      include PanelHelper # for panel
+
+      def fieldset(title = nil, &block)
+        options = {tag: :fieldset, body: @template.capture(&block)}
+        options[:heading] = title if title.present? && !inline_form?
+        panel options
+      end
+    end
+  end
+end

data/lib/bh/helpers/form/legend_helper.rb

@@ -0,0 +1,17 @@
+require 'bh/helpers/form/base_helper'
+
+module Bh
+  module Form
+    module LegendHelper
+      include BaseHelper
+
+      def legend(value, options = {})
+        append_class! options, 'sr-only' if inline_form?
+        text = content_tag :legend, value, options
+        text = content_tag :div, text, class: 'col-sm-12' if horizontal_form?
+        text = label_and_field_container(text, :legend) unless inline_form?
+        text
+      end
+    end
+  end
+end

data/lib/bh/helpers/form/radio_button_helper.rb

@@ -0,0 +1,19 @@
+require 'bh/helpers/form/base_helper'
+
+module Bh
+  module Form
+    module RadioButtonHelper
+      include BaseHelper
+
+      def radio_button(method, tag_value, options = {})
+        options.merge! offset: true, use_label: false
+        options[:label] ||= tag_value
+        base_field method, :radio_button, options do
+          label_and_field 'radio', method, options do
+            super method, tag_value, options
+          end
+        end
+      end
+    end
+  end
+end

data/lib/bh/helpers/form/select_helper.rb

@@ -0,0 +1,16 @@
+require 'bh/helpers/form/base_helper'
+
+module Bh
+  module Form
+    module SelectHelper
+      include BaseHelper
+
+      def select(method, choices = nil, options = {}, html_options = {}, &block)
+        append_class! html_options, 'form-control'
+        base_field method, :select, options do
+          super method, choices, options, html_options, &block
+        end
+      end
+    end
+  end
+end

data/lib/bh/helpers/form/static_control_helper.rb

@@ -0,0 +1,43 @@
+require 'bh/helpers/form/base_helper'
+
+module Bh
+  module Form
+    module StaticControlHelper
+      include BaseHelper
+
+      def static_control(text_or_options_with_block = nil, options = {}, &block)
+        text, options = if block_given?
+          [@template.capture(&block), text_or_options_with_block]
+        else
+          [text_or_options_with_block, options]
+        end
+        static_control_string text, options || {}
+      end
+
+    private
+
+      def static_control_string(text, options = {})
+        content_tag :div, class: 'form-group' do
+          if inline_form?
+              label = content_tag :label, options[:label], class: 'sr-only' if options[:label]
+              field = content_tag :p, text, class: 'form-control-static'
+              safe_join [label, field].compact
+          elsif horizontal_form?
+              label = content_tag :label, options[:label], class: 'col-sm-3 control-label' if options[:label]
+              field = content_tag :p, text, class: 'form-control-static'
+              if options[:label]
+              field = content_tag :div, field, class: 'col-sm-9'
+              else
+                field = content_tag :div, field, class: 'col-sm-9 col-sm-offset-3'
+              end
+              safe_join [label, field].compact
+          else
+              label = content_tag :label, options[:label] if options[:label]
+              field = content_tag :p, text, class: 'form-control-static'
+              safe_join [label, field].compact
+          end
+        end
+      end
+    end
+  end
+end

data/lib/bh/helpers/form/submit_helper.rb

@@ -0,0 +1,23 @@
+require 'bh/helpers/form/base_helper'
+
+module Bh
+  module Form
+    module SubmitHelper
+      include BaseHelper
+
+      def submit(value=nil, options={})
+        context = options.delete(:context) || 'primary'
+        append_class! options, "btn btn-#{context}"
+        if horizontal_form?
+          content_tag :div, class: 'form-group' do
+            content_tag :div, class: 'col-sm-offset-3 col-sm-9' do
+              super value, options
+            end
+          end
+        else
+          super value, options
+        end
+      end
+    end
+  end
+end

data/lib/bh/helpers/form_for_helper.rb

@@ -0,0 +1,30 @@
+require 'bh/helpers/base_helper'
+require 'bh/form_builders/form_builder'
+
+module Bh
+  module FormForHelper
+    include BaseHelper
+    include ActionView::Helpers::FormHelper # for form_for
+
+    def form_for(record, options = {}, &block)
+      add_form_options!(options) if options[:layout]
+      super record, options, &block
+    end
+
+  private
+
+    def add_form_options!(options)
+      options[:html] ||= {}
+      options[:html].merge! role: 'form'
+      append_class! options[:html], class_for(options[:layout])
+      options.merge! builder: FormBuilder
+    end
+
+    def class_for(layout)
+      case layout.to_s
+        when 'inline' then 'form-inline'
+        when 'horizontal' then 'form-horizontal'
+      end
+    end
+  end
+end

data/lib/bh/helpers/glyphicon_helper.rb

@@ -1,10 +1,10 @@
-require 'action_view'
+require 'bh/helpers/base_helper'
 
 module Bh
   # Provides methods to include Glyphicons.
   # @see http://getbootstrap.com/components/#glyphicons
   module GlyphiconHelper
-    include ActionView::Helpers::TagHelper # for content_tag
+    include BaseHelper
 
     # Returns an HTML block tag that follows the Bootstrap documentation
     # on how to display *glyphicons*.
@@ -16,9 +16,9 @@ module Bh
     # @example Display the "zoom out" glyphicon
     #   glyphicon 'zoom-out'
     def glyphicon(name = nil, options = {})
-      glyphicon_class = "glyphicon-#{name.to_s.gsub '_', '-'}" if name
-      klass = ['glyphicon', glyphicon_class].compact.join ' '
-      content_tag :span, nil, options.merge(class: klass)
+      append_class! options, 'glyphicon'
+      append_class! options, "glyphicon-#{name.to_s.gsub '_', '-'}" if name
+      content_tag :span, nil, options
     end
   end
 end

data/lib/bh/helpers/modal_helper.rb

@@ -1,11 +1,10 @@
-require 'action_view'
+require 'bh/helpers/base_helper'
 
 module Bh
   # Provides methods to include modals.
   # @see http://getbootstrap.com/javascript/#modals
   module ModalHelper
-    include ActionView::Helpers, ActionView::Context
-
+    include BaseHelper
 
     # Returns an HTML block tag that follows the Bootstrap documentation
     # on how to display *modals*.

data/lib/bh/helpers/panel_helper.rb

@@ -1,12 +1,10 @@
-require 'action_view'
+require 'bh/helpers/base_helper'
 
 module Bh
   # Provides methods to include panels.
   # @see http://getbootstrap.com/components/#panels
   module PanelHelper
-    include ActionView::Helpers::TagHelper # for content_tag
-    include ActionView::Context # for capture
-    include ActionView::Helpers::OutputSafetyHelper # for safe_join
+    include BaseHelper
 
     # Returns an HTML block tag that follows the Bootstrap documentation
     # on how to display *panels*.
@@ -36,6 +34,7 @@ module Bh
     # @option options [#to_s] :title if present, the panel will include a
     #   heading with the provided text wrapped in a 'panel-title' block, for
     #   proper title styling and link coloring.
+    # @option options [#to_s] :tag (:div) the HTML tag to wrap the panel in.
     # @see http://getbootstrap.com/components/#panels-heading
     def panel(content_or_options_with_block = nil, options = nil, &block)
       if block_given?
@@ -52,7 +51,8 @@ module Bh
     def panel_string(content = nil, options = {})
       content = prepend_optional_body_to content, options
       content = prepend_optional_heading_to content, options
-      content_tag :div, content, class: panel_class(options[:context])
+      tag = options.fetch :tag, :div
+      content_tag tag, content, class: panel_class(options[:context])
     end
 
     def panel_class(context = nil)

data/lib/bh/helpers/panel_row_helper.rb

@@ -1,4 +1,3 @@
-require 'action_view'
 require 'bh/helpers/panel_helper'
 
 module Bh
@@ -6,10 +5,7 @@ module Bh
   # @see http://getbootstrap.com/css/#grid
   # @see http://getbootstrap.com/components/#panels
   module PanelRowHelper
-    include ActionView::Helpers::TagHelper # for content_tag
-    include ActionView::Context # for capture
-    include ActionView::Helpers::OutputSafetyHelper # for safe_join
-    include Bh::PanelHelper # for panel
+    include PanelHelper # for panel
 
     # Returns an HTML block tag that follows the Bootstrap documentation
     # on how to display a *row*, passing column options to each panel in

data/lib/bh/railtie.rb

@@ -1,5 +1,6 @@
 require 'bh/helpers/alert_helper'
 require 'bh/helpers/cdn_helper'
+require 'bh/helpers/form_for_helper'
 require 'bh/helpers/glyphicon_helper'
 require 'bh/helpers/modal_helper'
 require 'bh/helpers/panel_helper'
@@ -11,6 +12,7 @@ module Bh
     initializer 'bh.add_helpers' do
       ActionView::Base.send :include, AlertHelper
       ActionView::Base.send :include, CdnHelper
+      ActionView::Base.send :include, FormForHelper
       ActionView::Base.send :include, GlyphiconHelper
       ActionView::Base.send :include, ModalHelper
       ActionView::Base.send :include, PanelHelper

data/lib/bh/version.rb

@@ -1,3 +1,3 @@
 module Bh
-  VERSION = '0.0.4'
+  VERSION = '0.0.5'
 end

data/spec/helpers/form/check_box_helper_spec.rb

@@ -0,0 +1,95 @@
+require 'spec_helper'
+require 'bh/helpers/form_for_helper'
+include Bh::FormForHelper
+
+describe 'check_box' do
+  attr_accessor :output_buffer
+  let(:protect_against_forgery?) { false }
+  let(:form) { form_for user, layout: layout, errors: errors, url: '/', &block }
+  let(:user) { User.new }
+  let(:errors) { {} }
+  let(:block) { Proc.new {|f| f.check_box :name, options} }
+  let(:options) { {} }
+
+  context 'given any layout' do
+    let(:layout) { :whatever }
+
+    specify 'not given a label option, automatically generates one' do
+      expect(form).to include 'Name</label>'
+    end
+
+    context 'given a label option, uses the provided one' do
+      let(:options) { {label: 'Given name'} }
+      it { expect(form).to include 'Given name</label>' }
+    end
+
+    specify 'not given an error, does not apply has-error to the form group' do
+      expect(form).not_to include 'has-error'
+    end
+
+    context 'given an error' do
+      before { user.errors.add :name, 'cannot be nil' }
+
+      specify 'shows errors and error messages' do
+        expect(form).to include 'has-error'
+        expect(form).to include '<span class="help-block text-left">cannot be nil</span>'
+      end
+    end
+  end
+
+  describe 'given a basic layout' do
+    let(:layout) { :basic }
+    specify 'applies checkbox to the container, and an inline label' do
+      expect(form).to match %r{<div class="checkbox"><label><input.+? /> Name</label></div>}
+    end
+
+    context 'given the inline_label: false option' do
+      let(:options) { {inline_label: false} }
+
+      specify 'aligns the label on top of the check-box' do
+        expect(form).to match %r{<label for="user_name">Name</label><input}
+        expect(form).to include 'input class="form-control"'
+      end
+    end
+  end
+
+  describe 'given a horizontal layout' do
+    let(:layout) { :horizontal }
+    specify 'applies form-group to the outer container, .col-sm-offset-3.col-sm-9 to the field container, checkbox to the container, and an inline label' do
+      expect(form).to match %r{<div class="form-group"><div class="col-sm-offset-3 col-sm-9"><div class="checkbox"><label><input.+? /> Name</label></div></div></div>}
+    end
+
+    context 'given the inline_label: false option' do
+      let(:options) { {inline_label: false} }
+
+      specify 'aligns the label on top of the check-box' do
+        expect(form).to match %r{<label class="col-sm-3 control-label" for="user_name">Name</label><div class="col-sm-9"><input}
+        expect(form).to include 'input class="form-control checkbox"'
+      end
+    end
+  end
+
+  describe 'given an inline layout' do
+    let(:layout) { :inline }
+    specify 'applies checkbox to the container, and an inline label' do
+      expect(form).to match %r{<div class="checkbox"><label><input.+? /> Name</label></div>}
+    end
+
+    context 'given an error' do
+      before { user.errors.add :name, 'cannot be nil' }
+
+      specify 'applies sr-only to the error message' do
+        expect(form).to include '<span class="help-block text-left sr-only">cannot be nil</span>'
+      end
+    end
+
+    context 'given the inline_label: false option' do
+      let(:options) { {inline_label: false} }
+
+      specify 'aligns the label on top of the check-box' do
+        expect(form).to match %r{<label class="sr-only" for="user_name">Name</label><input}
+        expect(form).not_to include 'form-control'
+      end
+    end
+  end
+end