bh 1.1.1 → 1.2.0

data/lib/bh/classes/panel_row.rb

@@ -0,0 +1,13 @@
+require 'bh/classes/base'
+
+module Bh
+  module Classes
+    class PanelRow < Base
+      # @return [#to_s] the grid-related class to assign to each panel
+      #   nested in this panel row.
+      def column_class
+        @options[:column_class]
+      end
+    end
+  end
+end

data/lib/bh/classes/progress_bar.rb

@@ -0,0 +1,89 @@
+require 'bh/classes/base'
+
+module Bh
+  module Classes
+    class ProgressBar < Base
+      # @return [#to_s] the context-related class to assign to the progress bar.
+      def context_class
+        ProgressBar.contexts[@options[:context]]
+      end
+
+      # @return [#to_s] the class to assign to make the progress bar striped.
+      def striped_class
+        ProgressBar.stripes[@options[:striped]]
+      end
+
+      # @return [#to_s] the class to assign to make the progress bar aniamted.
+      def animated_class
+        ProgressBar.animations[@options[:animated]]
+      end
+
+      # @return [#to_s] the text to display as the label of the progress bar.
+      def label
+        labels[@options.fetch :label, false] || @options[:label]
+      end
+
+      def aria_values
+        {}.tap do |values|
+          values[:'aria-valuemax'] = 100
+          values[:'aria-valuemin'] = 0
+          values[:'aria-valuenow'] = percentage
+        end
+      end
+
+      def values
+        {}.tap do |values|
+          values[:role] = :progressbar
+          values[:style] = "width: #{percentage}%"
+        end
+      end
+
+    private
+
+      # @return [Hash<Symbol, String>] the classes that Bootstrap requires to
+      #   append to the progress bar for each possible context.
+      def self.contexts
+        HashWithIndifferentAccess.new.tap do |klass|
+          klass[:danger]  = :'progress-bar-danger'
+          klass[:info]    = :'progress-bar-info'
+          klass[:success] = :'progress-bar-success'
+          klass[:warning] = :'progress-bar-warning'
+        end
+      end
+
+      # @return [Hash<Symbol, String>] the classes that Bootstrap requires to
+      #   append to the progress bar to make it look striped.
+      def self.stripes
+        HashWithIndifferentAccess.new.tap do |klass|
+          klass[true]  = :'progress-bar-striped'
+        end
+      end
+
+      # @return [Hash<Symbol, String>] the classes that Bootstrap requires to
+      #   append to the progress bar to make it look animated.
+      def self.animations
+        HashWithIndifferentAccess.new.tap do |klass|
+          klass[true]  = :'progress-bar-striped active'
+        end
+      end
+
+      # @return [Hash<Symbol, String>] the texts to uses as labels.
+      def labels
+        HashWithIndifferentAccess.new.tap do |label|
+          label[true]  = text
+          label[false]  = @app.content_tag(:span, text, class: 'sr-only')
+        end
+      end
+
+      def percentage
+        @options.fetch :percentage, 0
+      end
+
+      def text
+        "#{percentage}%".tap do |text|
+          text << " (#{@options[:context]})" if @options[:context]
+        end
+      end
+    end
+  end
+end

data/lib/bh/classes/stack.rb

@@ -0,0 +1,19 @@
+module Bh
+  module Classes
+    class Stack
+      @@stack = []
+
+      def self.unshift(item)
+        @@stack.unshift item
+      end
+
+      def self.shift
+        @@stack.shift
+      end
+
+      def self.find(helper_class)
+        @@stack.find{|helper| helper.is_a? helper_class}
+      end
+    end
+  end
+end

data/lib/bh/classes/vertical.rb

@@ -0,0 +1,27 @@
+require 'bh/classes/base'
+
+module Bh
+  module Classes
+    class Vertical < Base
+      def toggle_button(navbar_id, options = {})
+        options[:'class']       = :'navbar-toggle'
+        options[:'data-target'] = :"##{navbar_id}"
+        options[:'data-toggle'] = :'collapse'
+        options[:'type']        = :'button'
+        @app.content_tag :button, options do
+          safe_join [toggle_text, toggle_bar, toggle_bar, toggle_bar]
+        end
+      end
+
+    private
+
+      def toggle_text
+        @app.content_tag :span, 'Toggle navigation', class: :'sr-only'
+      end
+
+      def toggle_bar
+        @app.content_tag :span, nil, class: :'icon-bar'
+      end
+    end
+  end
+end

data/lib/bh/core_ext/middleman.rb

@@ -0,0 +1,24 @@
+module Bh
+  # @api private
+  # Provides methods to register Bh in third-party applications.
+  module Extensions
+    # Makes Bootstrap helpers available in Middleman applications.
+    #
+    # To use Bh in a Middleman app you need 2 steps:
+    #
+    #   - include bh in the Gemfile
+    #   - add `activate :bh` in the `config.rb` file
+    #
+    # The following class is registered as a Middleman extension, but you still
+    # need to activate it in the configuration file to make helpers available.
+    class MiddlemanExtension < Middleman::Extension
+      helpers do
+        include Bh::Helpers
+      end
+    end
+  end
+
+  Bh.framework = :middleman
+end
+
+::Middleman::Extensions.register(:bh, Bh::Extensions::MiddlemanExtension)

data/lib/bh/core_ext/padrino.rb

@@ -0,0 +1,25 @@
+module Bh
+  module Extensions
+    # Makes Bootstrap helpers available in Padrino applications.
+    #
+    # To use Bh in a Padrino app you need 2 steps:
+    #
+    #   - include bh in the Gemfile
+    #   - add `register Bh` in the `app.rb` file
+    #
+    # The following method adds `Bh` as one of the modules that can be registered
+    # in a Padrino app, but you still need to register it manually in order to
+    # make helpers available.
+    module Padrino
+      # Register Bh as a Padrino app.
+      def registered(app)
+        app.include Bh::Helpers
+      end
+    end
+
+    Bh.framework = :padrino
+  end
+
+  # Allows to register Bh in a Padrino app simply with `register Bh`.
+  extend Extensions::Padrino
+end

data/lib/bh/core_ext/rails/base_helper.rb

@@ -0,0 +1,21 @@
+require 'action_view'
+
+module Bh
+  module Rails
+    # @api private
+    module BaseHelper
+      include ActionView::Helpers::TagHelper # for content_tag
+      include ActionView::Context # for capture
+      include ActionView::Helpers::OutputSafetyHelper # for safe_join
+      include ActionView::Helpers::RenderingHelper # for render
+      include ActionView::Helpers::UrlHelper # for link_to
+
+    private
+
+      def append_class!(hash, new_class, attribute = :class)
+        existing_class = hash[attribute]
+        hash[attribute] = [existing_class, new_class].compact.join ' '
+      end
+    end
+  end
+end

data/lib/bh/{helpers → core_ext/rails}/form/base_helper.rb

@@ -1,9 +1,11 @@
+require 'bh/core_ext/rails/base_helper'
 require 'bh/helpers/glyphicon_helper'
 
 module Bh
   module Form
     module BaseHelper
-      include GlyphiconHelper # for glyphicon
+      include Bh::Rails::BaseHelper
+      include Bh::Helpers
 
     private
 

data/lib/bh/{helpers → core_ext/rails}/form/check_box_helper.rb

@@ -1,4 +1,4 @@
-require 'bh/helpers/form/base_helper'
+require 'bh/core_ext/rails/form/base_helper'
 
 module Bh
   module Form

data/lib/bh/{helpers → core_ext/rails}/form/field_helper.rb

@@ -1,4 +1,4 @@
-require 'bh/helpers/form/base_helper'
+require 'bh/core_ext/rails/form/base_helper'
 
 module Bh
   module Form

data/lib/bh/{helpers → core_ext/rails}/form/fields_for_helper.rb

@@ -1,4 +1,4 @@
-require 'bh/helpers/form/fieldset_helper'
+require 'bh/core_ext/rails/form/fieldset_helper'
 
 module Bh
   module Form

data/lib/bh/{helpers → core_ext/rails}/form/fieldset_helper.rb

@@ -4,7 +4,7 @@ module Bh
   module Form
     module FieldsetHelper
       include BaseHelper
-      include PanelHelper # for panel
+      include Bh::Helpers # for panel
 
       def fieldset(title = nil, &block)
         options = {tag: :fieldset, body: @template.capture(&block)}

data/lib/bh/{helpers → core_ext/rails}/form/file_field_helper.rb

@@ -1,4 +1,4 @@
-require 'bh/helpers/form/base_helper'
+require 'bh/core_ext/rails/form/base_helper'
 
 module Bh
   module Form

data/lib/bh/{helpers → core_ext/rails}/form/legend_helper.rb

@@ -1,4 +1,4 @@
-require 'bh/helpers/form/base_helper'
+require 'bh/core_ext/rails/form/base_helper'
 
 module Bh
   module Form

data/lib/bh/{helpers → core_ext/rails}/form/radio_button_helper.rb

@@ -1,4 +1,4 @@
-require 'bh/helpers/form/base_helper'
+require 'bh/core_ext/rails/form/base_helper'
 
 module Bh
   module Form

data/lib/bh/{helpers → core_ext/rails}/form/select_helper.rb

@@ -1,4 +1,4 @@
-require 'bh/helpers/form/base_helper'
+require 'bh/core_ext/rails/form/base_helper'
 
 module Bh
   module Form

data/lib/bh/{helpers → core_ext/rails}/form/static_control_helper.rb

@@ -1,4 +1,4 @@
-require 'bh/helpers/form/base_helper'
+require 'bh/core_ext/rails/form/base_helper'
 
 module Bh
   module Form

data/lib/bh/{helpers → core_ext/rails}/form/submit_helper.rb

@@ -1,4 +1,4 @@
-require 'bh/helpers/form/base_helper'
+require 'bh/core_ext/rails/form/base_helper'
 
 module Bh
   module Form

data/lib/bh/{form_builders → core_ext/rails}/form_builder.rb

@@ -1,15 +1,16 @@
-require 'bh/helpers/form/check_box_helper'
-require 'bh/helpers/form/field_helper'
-require 'bh/helpers/form/fieldset_helper'
-require 'bh/helpers/form/fields_for_helper'
-require 'bh/helpers/form/file_field_helper'
-require 'bh/helpers/form/legend_helper'
-require 'bh/helpers/form/radio_button_helper'
-require 'bh/helpers/form/select_helper'
-require 'bh/helpers/form/static_control_helper'
-require 'bh/helpers/form/submit_helper'
+require 'bh/core_ext/rails/form/check_box_helper'
+require 'bh/core_ext/rails/form/field_helper'
+require 'bh/core_ext/rails/form/fieldset_helper'
+require 'bh/core_ext/rails/form/fields_for_helper'
+require 'bh/core_ext/rails/form/file_field_helper'
+require 'bh/core_ext/rails/form/legend_helper'
+require 'bh/core_ext/rails/form/radio_button_helper'
+require 'bh/core_ext/rails/form/select_helper'
+require 'bh/core_ext/rails/form/static_control_helper'
+require 'bh/core_ext/rails/form/submit_helper'
 
 module Bh
+  # @api private
   class FormBuilder < ActionView::Helpers::FormBuilder
     include Form::CheckBoxHelper
     include Form::FieldHelper

data/lib/bh/core_ext/rails/form_for_helper.rb

@@ -0,0 +1,32 @@
+require 'bh/core_ext/rails/base_helper'
+require 'bh/core_ext/rails/form_builder'
+
+module Bh
+  module Rails
+    module Helpers
+      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
+end

data/lib/bh/core_ext/railtie.rb

@@ -0,0 +1,27 @@
+require 'bh/core_ext/rails/form_for_helper'
+
+module Bh
+  module Extensions
+    # Makes Bootstrap helpers available in Rails applications.
+    #
+    # To use Bh in a Rails app you need 1 step:
+    #
+    #   - include bh in the Gemfile
+    #
+    # The current class is loaded during the initialization process, so
+    # there is no need to manually require any other file.
+    class Railtie < ::Rails::Railtie
+      initializer 'bh.add_helpers' do
+        ActionView::Base.send :include, Bh::Helpers
+        ActionView::Base.send :include, Bh::Rails::Helpers
+      end
+
+      initializer 'bh.add_views' do |app|
+        views_path = File.expand_path '../../views', __FILE__
+        ActionController::Base.prepend_view_path views_path
+      end
+    end
+  end
+
+  Bh.framework = :rails
+end

data/lib/bh/helpers/alert_box_helper.rb

@@ -0,0 +1,40 @@
+require 'bh/classes/alert_box'
+
+module Bh
+  module Helpers
+    # Displays a Bootstrap-styled alert message.
+    # @see http://getbootstrap.com/components/#alerts
+    # @return [String] the HTML to display a Bootstrap-styled alert message.
+    # @overload alert_box(content, options = {})
+    #   @param [#to_s] content the content to display in the alert.
+    #   @param [Hash] options the options for the alert box. Any option not
+    #     listed below is passed as an HTML attribute to the alert’s `<div>`.
+    #   @option options [Boolean] :dismissible (false) whether to display an
+    #     '×' to the right of the box that can be clicked to dismiss the alert.
+    #   @option options [#to_s] :context (:info) the contextual alternative to
+    #     apply to the alert. Can be `:danger`, `:info`, `:success` or
+    #     `:warning`.
+    #   @option options [#to_s] :priority if set to one of the priority levels
+    #     of Rails flash contents, determines the context of the alert box.
+    #     Can be :alert or :notice.
+    #   @example Display a dismissible alert box with a plain-text content.
+    #       alert_box 'User updated successfully', dismissible: true
+    # @overload alert_box(options = {}, &block)
+    #   @param [Hash] options the options for the alert box (see above).
+    #   @yieldreturn [#to_s] the content to display in the alert.
+    #   @example Display a success alert box with an HTML content.
+    #       alert_box context: :success do
+    #         content_tag :strong, 'User updated successfully'
+    #       end
+    def alert_box(*args, &block)
+      alert_box = Bh::AlertBox.new(self, *args, &block)
+      alert_box.extract! :context, :priority, :dismissible
+
+      alert_box.append_class! :alert
+      alert_box.append_class! alert_box.context_class
+      alert_box.merge! role: :alert
+      alert_box.prepend_html! alert_box.dismissible_button
+      alert_box.render_tag :div
+    end
+  end
+end