bootstrap3_helper 2.0.0 → 3.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: fa4a4982f3b39160bbef89613d224a4445460f48f7c57493f13b2e716a762c27
-  data.tar.gz: d896ed4c7700a1d4be61432c016790de7774a8fef92b3942a5c9e43f8b45531e
+  metadata.gz: 4052a52cedf01461e605010a66bbf78a2f1741e4046a755495226edeccff6027
+  data.tar.gz: 538817f6096634dcfead3335a03198f34bcecc987d95d22561f79e34553ffa50
 SHA512:
-  metadata.gz: a69b36f433d89b6003e8b7662dc3b2c0eae7b1d2e2241eb87aa8b168f3cd15cd48acf0b55e893c44366ba311bb48ce5e20ceb3595b4b57ebce58e64d52f5d2f6
-  data.tar.gz: bfb6e3bb9c1472159609be87b92aff76e7bc28c40249a2b721610acbb3a002d8118b290f2bc006e2b595a0bf0cfdf86616795318cab1dd47070abb51c456262f
+  metadata.gz: bc609fbe4d4cb0d76fcd70155ee21b9edb27741cd4b590bacce764408d34ca4fc47232ba4458fb6a657c9c4894a7310675ac6d774ae6ad567a31724b8fd52ebb
+  data.tar.gz: c6e1cdca50954072d204055706352aca4ee29abaa394749d1c623b2ce9eb43d970c3d5da51663cd641ccee0a98382459ebf4ee8f169ef3acc044186940c7b17b

data/README.md

@@ -18,14 +18,42 @@ Or install it yourself as:
 
     $ gem install bootstrap3_helper
 
-## Usage
+## Panel Helper
 
-`Panel Helper`
+Panels supper the following methods:
+
+- body
+- heaader
+- footer
+- title
+
+```ruby
+# @overload panel_helper(context, opts)
+#   @param  [String|Symbol] context - :primary, :danger etc
+#   @param  [Hash] opts
+#   @option opts [String] :id
+#   @option opts [String] :class
+#   @option opts [Hash]   :data
+#   @option opts [Hash]   :aria
+#
+# @overload panel_helper(opts)
+#   @param  [Hash] opts
+#   @option opts [String] :id
+#   @option opts [String] :class
+#   @option opts [Hash]   :data
+#   @option opts [Hash]   :aria
+#
+# @yieldparam [Panel] panel
+# @return [String]
+```
+
+#### Example
 
 ```erb
 <%= panel_helper :primary do |p| %>
   <%= p.header id: 'optional-id', class: 'any-optional-extra-classes' do %>
-    Some Header for your panel
+    <%= p.header { 'Optional header title' }  %>
+    <p>Non styled content for header...</p>
   <% end %>
   <%= p.body id: 'optional-id', class: 'any-optional-extra-classes' do %>
      All your custom HTML or Ruby.  You can render blocks here, whatever
@@ -37,9 +65,25 @@ Or install it yourself as:
 end
 ```
 
----
+## Alert Helper
+
+```ruby
+# @overload alert_helper(context, opts)
+#   @param  [Symbol|String] context - :primary, :danger etc
+#   @param  [Hash] opts
+#   @option opts [String]  :id
+#   @option opts [String]  :class
+#   @option opts [Boolean] :dismissible
+#
+# @overload alert_helper(opts)
+#   @param  [Hash] opts
+#   @option opts [String] :id
+#   @option opts [String] :class
+#
+# @return [String]
+```
 
-`Alert Helper`
+### Example
 
 ```erb
 <%= alert_helper :success { 'Some success message' } %>
@@ -51,12 +95,28 @@ end
 <% end %>
 ```
 
----
+## Acordion Helper
 
-`Accordion Helper`
+```ruby
+# @overload accordion_helper(context, opts)
+#   @param  [Symbol|String] context - :primary, :danger etc
+#   @param  [Hash] opts
+#   @option opts [String] :id
+#   @option opts [String] :class
+#
+# @overload accordion_helper(opts)
+#   @param  [Hash] opts
+#   @option opts [String] :id
+#   @option opts [String] :class
+#
+# @yieldparam [Accordion] accordion
+# @return [String]
+```
+
+### Example
 
 ```erb
-<%= accordion_helper :primary, { class: 'optional-class', id: 'optional_id', collapse_id: 'optional_collapse_id', expanded: true } do |accordion| %>
+<%= accordion_helper :primary, id: 'optional_id', expanded: true do |accordion| %>
     <%= accordion.header do %>
         <span class="something">This is the heading....</span>
     <% end %>
@@ -66,11 +126,19 @@ end
 <% end %>
 ```
 
-**Note:** the accordion helper handles all the attributes and data attributes needed to sync up the javascript in order to give the component its functionality. You just worry about about the class or state of the component. The helper does the rest. But if you do want to control the collapse ID and syncing, `collapse_id` is the attribute you are looking for.
+**Note:** the accordion helper handles all the attributes and data attributes needed to sync up the javascript in order to give the component its functionality. You just worry about about the class or state of the component. The helper does the rest. But if you do want to control the collapse ID and syncing, `collapse_id` is the parameter you are looking for.
 
----
+## Accordion Group
 
-`AccordionGroup Helper`
+```ruby
+# @param  [Hash] opts
+# @option opts [String] :id
+# @option opts [String] :class
+# @yieldparam [AccordionGroup] group
+# @return [String]
+```
+
+### Example
 
 ```erb
 <%= accordion_group_helper do |g| %>
@@ -95,41 +163,58 @@ end
 <% end %>
 ```
 
-**Note:** the accordion_group helper handles all the attributes and data attributes needed to sync up the javascript in order to give the component its functionality. You just worry about about the class or state of the individual accordions. The helper does the rest.
+## Tab Helper
 
----
+Tabs respond to the following methods:
 
-`Tab Helper`
+- menu
+  - item (Used for linking to tab content)
+  - dropdown (Used for making dropdown menus)
+- content
 
-```erb
-<%= tabs_helper type: :pills do |menu, content| %>
-    <% menu.item(:testing1, class: 'active') { ' Testing 1' } %>
-    <% menu.item :testing2 %>
-    <% menu.item(:testing3) { ' Testing 3' } %>
-    <% menu.dropdown 'Testing Dropdown' do |dropdown| %>
-        <%= dropdown.item(:testing5 ) { 'Testing 5' } %>
-        <%= dropdown.item(:testing6 ) { 'Testing 6' } %>
-        <%= dropdown.item(:testing7 ) { 'Testing 7' } %>
-    <% end %>
+```ruby
+# @param  [Hash] opts
+# @option args [String|Symbol] :type - :tabs, :pills
+# @option args [String]        :id
+# @option args [String]        :class
+# @yieldparam [Tabs] tabs
+# @return [String]
+```
 
+### Example
 
-    <% content.item :testing1, class: 'active' do %>
-        Testing 1 content
-    <% end %>
-    <% content.item :testing2 do %>
-        Testing 2 content
-    <% end %>
-    <% content.item :testing3 do %>
-        Testing 3 content
-    <% end %>
-    <% content.item :testing5 do %>
-        Testing 5 content
-    <% end %>
-    <% content.item :testing6 do %>
-        Testing 6 content
+```erb
+<%= tabs_helper type: :pills do |tabs| %>
+    <%= tabs.menu do |menu| %>
+        <%= menu.item(:testing1, class: 'active') { ' Testing 1' } %>
+        <%= menu.item :testing2 %>
+        <%= menu.item(:testing3) { ' Testing 3' } %>
+        <%= menu.dropdown 'Testing Dropdown' do |dropdown| %>
+            <%= dropdown.item(:testing5 ) { 'Testing 5' } %>
+            <%= dropdown.item(:testing6 ) { 'Testing 6' } %>
+            <%= dropdown.item(:testing7 ) { 'Testing 7' } %>
+        <% end %>
     <% end %>
-    <% content.item :testing7 do %>
-        Testing 7 content
+
+    <%= tabs.content do |content| %>
+        <% content.pane :testing1, class: 'active' do %>
+            Testing 1 content
+        <% end %>
+        <% content.pane :testing2 do %>
+            Testing 2 content
+        <% end %>
+        <% content.pane :testing3 do %>
+            Testing 3 content
+        <% end %>
+        <% content.pane :testing5 do %>
+            Testing 5 content
+        <% end %>
+        <% content.pane :testing6 do %>
+            Testing 6 content
+        <% end %>
+        <% content.pane :testing7 do %>
+            Testing 7 content
+        <% end %>
     <% end %>
 <% end %>
 ```

data/lib/bootstrap3_helper/accordion.rb

@@ -1,17 +1,6 @@
 module Bootstrap3Helper # :nodoc:
   # Used to generate Bootstrap Accordion objects.
   #
-  # @example Render out an Accordion component in a template:
-  #   <code>
-  #     <%= accordion_helper :primary do |accordion| %>
-  #         <%= accordion.header do %>
-  #             <span class="something">This is the heading....</span>
-  #         <% end %>
-  #         <%= accordion.body do %>
-  #             <p>This is the body of the accordion....</p>
-  #         <% end %>
-  #     <% end %>
-  #   </code>
   #
   class Accordion < Component
     # Initlize a new accordion object.  If this part of a parent element, i.e
@@ -19,7 +8,7 @@ module Bootstrap3Helper # :nodoc:
     # pass it down to the other components.
     #
     # @param [Class] template - Template in which your are binding too.
-    # @param [NilClass|String|Symbol|Hash] - Bootstrap class context, or options hash.
+    # @param [NilClass|String|Symbol|Hash] context_or_options Bootstrap class context, or options hash.
     # @param [Hash] opts
     # @option opts [String]  :parent_id   The parent element ID if this accordion is part of a group.
     # @option opts [String]  :id          The ID of the element
@@ -30,7 +19,7 @@ module Bootstrap3Helper # :nodoc:
     #
     def initialize(template, context_or_options = nil, opts = {}, &block)
       super(template)
-      @context, args = parse_arguments(context_or_options, opts)
+      @context, args = parse_context_or_options(context_or_options, opts)
 
       @parent_id   = args.fetch(:parent_id, nil)
       @id          = args.fetch(:id, nil)
@@ -41,27 +30,27 @@ module Bootstrap3Helper # :nodoc:
       @panel       = Panel.new(@template, context_or_options, opts)
     end
 
-    # rubocop:disable Metrics/MethodLength
-
     # Creates the header element for the accordion
     #
-    # @note NilClass :to_s  returns an empty String
-    #
-    # @params [Hash] args
+    # @param  [Symbol|String|Hash|NilClass] tag_or_options
+    # @param  [Hash] opts
     # @option opts [String] :id
     # @option opts [String] :class
     # @option opts [Hash]   :data
-    # @yieldreturn [String]
+    # @option opts [Hash]   :aria
+    # @return [String]
     #
-    def header(args = {}, &block)
-      data          = args.fetch(:data, {})
+    def header(tag_or_options = nil, opts = {}, &block)
+      tag, args = parse_tag_or_options(tag_or_options, opts)
+
+      data          = {}
       data[:toggle] = 'collapse'
       data[:parent] = "##{@parent_id}" if @parent_id.present?
+      data[:target] = "##{@collapse_id}"
 
-      @panel.header(args) do
+      @panel.header(tag, args.merge!(config_for: :accordions)) do
         content_tag(
-          :a,
-          href: "##{@collapse_id}",
+          :span,
           role: 'button',
           data: data,
           aria: { expanded: @expanded, controls: "##{@collapse_id}" },
@@ -69,21 +58,35 @@ module Bootstrap3Helper # :nodoc:
         )
       end
     end
-    # rubocop:enable Metrics/MethodLength
 
-    # rubocop:disable Metrics/MethodLength
+    # Builds a title component for the accordion header.
+    #
+    # @param  [Symbol|String|Hash|NilClass] tag_or_options
+    # @param  [Hash] opts
+    # @option opts [String] :id
+    # @option opts [String] :class
+    # @option opts [Hash]   :data
+    # @option opts [Hash]   :aria
+    # @return [String]
+    #
+    def title(tag_or_options = nil, opts = {}, &block)
+      tag, args = parse_tag_or_options(tag_or_options, opts)
+      @panel.title(tag, args.merge!(config_for: :accordions), &block)
+    end
 
     # Creates the body element for the accordion.
     #
     # @note NilClass :to_s  returns an empty String
     #
-    # @params [Hash] args
-    # @option opts [String] :id
-    # @option opts [String] :class
-    # @option opts [Hash]   :data
+    # @param [Hash] args
+    # @option args [String] :id
+    # @option args [String] :class
+    # @option args [Hash]   :data
     # @yieldreturn [String]
     #
-    def body(args = {}, &block)
+    def body(tag_or_options = nil, opts = {}, &block)
+      tag, args = parse_tag_or_options(tag_or_options, opts)
+
       klass = 'panel-collapse collapse '
       klass += ' in' if @expanded
 
@@ -94,21 +97,21 @@ module Bootstrap3Helper # :nodoc:
         class: klass,
         aria:  { labelledby: "##{@collapse_id}" }
       ) do
-        @panel.body(args, &block)
+        @panel.body(tag, args.merge!(config_for: :accordions), &block)
       end
     end
-    # rubocop:enable Metrics/MethodLength
 
     # Creates the footer element for the accordion
     #
-    # @params [Hash] args
-    # @option opts [String] :id
-    # @option opts [String] :class
-    # @option opts [Hash]   :data
-    # @yieldreturn [String]
+    # @param [Hash] args
+    # @option args [String] :id
+    # @option args [String] :class
+    # @option args [Hash]   :data
+    # @return [String]
     #
-    def footer(args = {}, &block)
-      @panel.footer(args, &block)
+    def footer(tag_or_options = nil, opts = {}, &block)
+      tag, args = parse_tag_or_options(tag_or_options, opts)
+      @panel.footer(tag, args.merge!(config_for: :accordions), &block)
     end
 
     # The to string method here is what is responsible for rendering out the
@@ -118,7 +121,7 @@ module Bootstrap3Helper # :nodoc:
     # @return [String]
     #
     def to_s
-      content = content_tag :div, id: @id, class: container_classes do
+      content_tag :div, id: @id, class: container_classes do
         @content.call(self)
       end
     end

data/lib/bootstrap3_helper/accordion_group.rb

@@ -1,7 +1,7 @@
 module Bootstrap3Helper # :nodoc:
   # This class is used to general groups of accordions.
   #
-  # @eample Rendering out an Accordion Group in template:
+  # @example Rendering out an Accordion Group in template:
   #   <code>
   #     <%= accordion_group_helper do |group| %>
   #       <%= group.accordion :primary do |accordion| %>
@@ -48,11 +48,11 @@ module Bootstrap3Helper # :nodoc:
     # This method is the main method for generating individual accordions.
     # This is where you would pass in the html attributes.
     #
-    # @param [NilClass|String|Symbol|Hash] - Bootstrap class context, or options hash.
+    # @param [NilClass|String|Symbol|Hash] context_or_options
     # @param [Hash] opts
-    # @option args [String] id    The ID, if you want one, for the parent container
-    # @option args [String] class Custom class for the parent container
-    # @yieldparam accordion [Accordion]
+    # @option opts [String] :id
+    # @option opts [String] :class
+    # @yieldreturn [Accordion] accordion
     #
     def accordion(context_or_options = nil, opts = {}, &block)
       if context_or_options.is_a?(Hash)
@@ -71,7 +71,7 @@ module Bootstrap3Helper # :nodoc:
     # @return [String]
     #
     def to_s
-      content = content_tag :div, id: @id, class: "panel-group #{@class}" do
+      content_tag :div, id: @id, class: "panel-group #{@class}" do
         @content.call(self)
       end
     end

data/lib/bootstrap3_helper/alert.rb

@@ -2,22 +2,11 @@ module Bootstrap3Helper # :nodoc:
   # The Alert helper is meant to help you rapidly build Bootstrap Alert
   # components quickly and easily. The dissmiss button is optional.
   #
-  # @example Rendering a Bootstrap Alert Component in a view:
-  #   <code>
-  #     <%= alert_helper :warning, dismissable: true do %>
-  #       <% if @model.errors.present? %>
-  #         <p>Some kind of error</p>
-  #       <% end %>
-  #     <% end %>
-  #
-  #     <%= alert_helper(:success, dismissible: true) { "Successful save"}
-  #   </code>
-  #
   class Alert < Component
     # Used to generate Bootstrap alert components quickly.
     #
-    # @param  [Class] template Template in which your are binding too.
-    # @param  [NilClass|String|Symbol|Hash] Bootstrap class context, or options hash.
+    # @param  [ActionView] template Template in which your are binding too.
+    # @param  [NilClass|String|Symbol|Hash] context_or_options Bootstrap class context, or options hash.
     # @param  [Hash]  opts
     # @option opts [String]  :id    The ID of the element
     # @option opts [String]  :class Custom class for the component.
@@ -25,12 +14,12 @@ module Bootstrap3Helper # :nodoc:
     #
     def initialize(template, context_or_options = nil, opts = {}, &block)
       super(template)
-      @context, args = parse_arguments(context_or_options, opts)
 
-      @id          = args.fetch(:id, nil)
-      @class       = args.fetch(:class, '')
-      @dismissible = args.fetch(:dismissible, false)
-      @content     = block || proc { '' }
+      @context, args = parse_context_or_options(context_or_options, opts)
+      @id            = args.fetch(:id, nil)
+      @class         = args.fetch(:class, '')
+      @dismissible   = args.fetch(:dismissible, false)
+      @content       = block || proc { '' }
     end
 
     # The dissmiss button, if the element has one.
@@ -38,7 +27,12 @@ module Bootstrap3Helper # :nodoc:
     # @return [String]
     #
     def close_button
-      content_tag(:button, class: 'close', data: { dismiss: 'alert' }, aria: { label: 'Close' }) do
+      content_tag(
+        :button,
+        class: 'close',
+        data:  { dismiss: 'alert' },
+        aria:  { label: 'Close' }
+      ) do
         content_tag(:span, aria: { hidden: true }) { '&times;'.html_safe }
       end
     end

data/lib/bootstrap3_helper/callout.rb

@@ -3,8 +3,8 @@ module Bootstrap3Helper # :nodoc:
   #
   #
   class Callout < Component
-    # @param  [Class] template - Template in which your are binding too.
-    # @param  [NilClass|String|Symbol|Hash] - Bootstrap class context, or options hash.
+    # @param  [ActionView] template Template in which your are binding too.
+    # @param  [NilClass|String|Symbol|Hash] context_or_options Bootstrap class context, or options hash.
     # @param  [Hash]  opts
     # @option opts [String]  :id    The ID of the element
     # @option opts [String]  :class Custom class for the component.
@@ -12,7 +12,7 @@ module Bootstrap3Helper # :nodoc:
     #
     def initialize(template, context_or_options = nil, opts = {}, &block)
       super(template)
-      @context, args = parse_arguments(context_or_options, opts)
+      @context, args = parse_context_or_options(context_or_options, opts)
 
       @id      = args.fetch(:id, nil)
       @class   = args.fetch(:class, '')

data/lib/bootstrap3_helper/component.rb

@@ -15,7 +15,7 @@ module Bootstrap3Helper # :nodoc
     # Used to ensure that the helpers always have the propert context for
     # rendering and bindings.
     #
-    # @param [Class] template - the context of the bindings
+    # @param [ActionView] template the context of the bindings
     #
     def initialize(template)
       @template = template
@@ -46,7 +46,7 @@ module Bootstrap3Helper # :nodoc
     # binding. Concat adds a String to the template Output buffer.  Useful when
     # trying to add a String with no block.
     #
-    # @params [String] text
+    # @param [String] text
     #
     def concat(text)
       @template.concat(text)
@@ -57,14 +57,46 @@ module Bootstrap3Helper # :nodoc
     # contectual class.  So we will assign it to `default` and
     # return the Hash to be used as options.
     #
-    # @params [Hash|NilClass|String|Symbol] *args
+    # @param  [Hash|NilClass|String|Symbol] args
     # @return [Array]
     #
-    def parse_arguments(*args)
+    def parse_context_or_options(*args)
+      parse_arguments(*args, 'default')
+    end
+
+    # Used to parse method arguments.  If the first argument is
+    # a Hash, then it is assumed that the user left off the tag
+    # element.  So we will assign it to <tt>NilClass</tt> and
+    # return the Hash to be used as options.
+    #
+    # @param  [Hash|NilClass|String|Symbol] args
+    # @return [Array]
+    #
+    def parse_tag_or_options(*args)
+      parse_arguments(*args, nil)
+    end
+
+    # Used to parse method arguments.  If the first argument is
+    # a Hash, then it is assumed that the user left off the bootstrap
+    # contectual class.  So we will assign it to `default` and
+    # return the Hash to be used as options.
+    #
+    # @overload parse_arguments(param_or_options, options, default)
+    #   @param [NilClass|Hash|Symbol|String] param_or_options
+    #   @param [Hash] options
+    #   @param [NilClass|String|Symbol] default
+    #
+    # @overload parse_arguments(options, default)
+    #   @param [Hash] options
+    #   @param [NilClass|String|Symbol] default
+    #
+    # @return [Array]
+    #
+    def parse_arguments(*args, default)
       first, second = *args
       case first
       when Hash, NilClass
-        ['default', first || second]
+        [default, first || second]
       when Symbol, String
         [first, second]
       end
@@ -78,5 +110,25 @@ module Bootstrap3Helper # :nodoc
     def uuid
       (0...10).map { rand(65..90).chr }.join
     end
+
+    # Used to get config settings inside of components quicker.
+    #
+    # @param  [Symbol|String|Hash] setting
+    # @return [Mixed]
+    #
+    def config(setting, fallback)
+      object = Bootstrap3Helper.config
+
+      value  = (
+        case setting
+        when Hash
+          object.send(setting.keys[0])[setting.values[0]] if object.send(setting.keys[0])
+        when Symbol, String
+          object.send(setting) if object.respond_to?(setting)
+        end
+      )
+
+      value || fallback
+    end
   end
 end

data/lib/bootstrap3_helper/configuration.rb

@@ -6,19 +6,30 @@ module Bootstrap3Helper
   #
   #
   class Configuration
-    SETTINGS = %i[
-      autoload_in_all_views
-    ].freeze
+    DEFAULT_SETTINGS = {
+      autoload_in_all_views: true,
+      accodions:             {
+        header: :div,
+        body:   :div,
+        footer: :div,
+        title:  :h4
+      },
+      panels:                {
+        header: :div,
+        body:   :div,
+        footer: :div,
+        title:  :h3
+      }
+    }.freeze
 
-    attr_accessor(*SETTINGS)
+    attr_accessor(*DEFAULT_SETTINGS.keys)
 
-    # @description
-    # -
+    # Class constructor
     #
-    # @params [Hash] args
+    # @param  [Hash] _args
     # @return [ClassName]
     #
-    def initialize(args = {})
+    def initialize(_args = {})
       @autoload_in_all_views = true
     end
   end

data/lib/bootstrap3_helper/initialize.rb

@@ -0,0 +1,19 @@
+module Bootstrap3Helper # :nodoc:
+  # Naming convention used as to not pollute views where the module is
+  # included.  @config is a common instance variable name.  We don't want
+  # to risk overriding another developers variable.
+  #
+  @_bs3h_config = Configuration.new
+
+  class << self
+    # Simple interface for exposing the configuration object.
+    #
+    # @return [Bootstrap5Helper::Configuration]
+    #
+    def config
+      yield @_bs3h_config if block_given?
+
+      @_bs3h_config
+    end
+  end
+end

data/lib/bootstrap3_helper/panel.rb

@@ -1,80 +1,140 @@
 module Bootstrap3Helper # :nodoc:
   # Used to rapidly build Bootstrap Panel Components.
   #
-  # @example Rendering a Bootstrap Panel Component in a view:
-  #   <%= panel_helper class: 'panel-primary' do |p| %>
-  #     <%= p.header { "Some Title" }
-  #     <%= p.body class: 'custom-class', id: 'custom-id' do %>
-  #       //HTML or Ruby code here...
-  #     <% end %>
-  #     <%= p.footer do %>
-  #       //HTML or Ruby
-  #     <% end %>
-  #   <% end %>
   #
   class Panel < Component
     # Creates a new Panel object.
     #
-    # @param [Class] template - Template in which your are binding too.
-    # @param [NilClass|String|Symbol|Hash] - Bootstrap class context, or options hash.
+    # @param [ActionView] template - Template in which your are binding too.
+    # @param [NilClass|String|Symbol|Hash] context_or_options - Bootstrap class context, or options hash.
     # @param [Hash]  opts
-    # @option opts [String]  :id    The ID of the element
-    # @option opts [String]  :class Custom class for the component.
-    # @option opts [Hash]    :data  Any data attributes for the element.
+    # @option opts [String]  :id    - The ID of the element
+    # @option opts [String]  :class - Custom class for the component.
+    # @option opts [Hash]    :data  - Any data attributes for the element.
+    # @option opts [Symbol]  :config_type - Used to change config from Panel to Accordion.
     # @return [Panel]
     #
     def initialize(template, context_or_options = nil, opts = {}, &block)
       super(template)
-      @context, args = parse_arguments(context_or_options, opts)
+      @context, args = parse_context_or_options(context_or_options, opts)
 
-      @id      = args.fetch(:id, '')
-      @class   = args.fetch(:class, '')
-      @data    = args.fetch(:data, nil)
-      @content = block || proc { '' }
+      @id          = args.fetch(:id,          '')
+      @class       = args.fetch(:class,       '')
+      @data        = args.fetch(:data,        nil)
+      @config_type = args.fetch(:config_type, :panels)
+      @content     = block || proc { '' }
     end
 
     # Used to generate the header component for the panel.
     #
-    # @param [Hash] args
-    # @option args [String]  :id    The ID of the element
-    # @option args [String]  :class Custom class for the component.
-    # @yieldreturn [String]
+    # @param  [Symbol|String|Hash|NilClass] tag_or_options
+    # @param  [Hash] opts
+    # @option opts [String] :id
+    # @option opts [String] :class
+    # @option opts [Hash]   :data
+    # @option opts [Hash]   :aria
+    # @return [String]
     #
-    def header(args = {}, &block)
-      id    = args.fetch(:id, '')
+    def header(tag_or_options = nil, opts = {}, &block)
+      tag, args = parse_tag_or_options(tag_or_options, opts)
+
+      id    = args.fetch(:id,    nil)
       klass = args.fetch(:class, '')
+      data  = args.fetch(:data,  {})
+      aria  = args.fetch(:aria,  {})
 
-      content_tag(:div, id: id, class: 'panel-heading ' + klass) do
-        content_tag(:h3, class: 'panel-title', &block)
-      end
+      content_tag(
+        tag || config({ @config_type => :header }, :div),
+        id:    id,
+        class: "panel-heading #{klass}",
+        data:  data,
+        aria:  aria,
+        &block
+      )
+    end
+
+    # Builds a title component for the panel.
+    #
+    # @param  [Symbol|String|Hash|NilClass] tag_or_options
+    # @param  [Hash] opts
+    # @option opts [String] :id
+    # @option opts [String] :class
+    # @option opts [Hash]   :data
+    # @option opts [Hash]   :aria
+    # @return [String]
+    #
+    def title(tag_or_options = nil, opts = {}, &block)
+      tag, args = parse_tag_or_options(tag_or_options, opts)
+
+      id    = args.fetch(:id,    nil)
+      klass = args.fetch(:class, '')
+      data  = args.fetch(:data,  {})
+      aria  = args.fetch(:aria,  {})
+
+      content_tag(
+        tag || config({ @config_type => :title }, :h3),
+        id:    id,
+        class: "panel-title #{klass}",
+        data:  data,
+        aria:  aria,
+        &block
+      )
     end
 
     # Used to generate the body component for the panel.
     #
-    # @param [Hash] args
-    # @option args [String]  :id    The ID of the element
-    # @option args [String]  :class Custom class for the component.
-    # @yieldreturn [String]
+    # @param  [Symbol|String|Hash|NilClass] tag_or_options
+    # @param  [Hash] opts
+    # @option opts [String] :id
+    # @option opts [String] :class
+    # @option opts [Hash]   :data
+    # @option opts [Hash]   :aria
+    # @return [String]
     #
-    def body(args = {}, &block)
-      id    = args.fetch(:id, '')
+    def body(tag_or_options = nil, opts = {}, &block)
+      tag, args = parse_tag_or_options(tag_or_options, opts)
+
+      id    = args.fetch(:id,    nil)
       klass = args.fetch(:class, '')
+      data  = args.fetch(:data,  {})
+      aria  = args.fetch(:aria,  {})
 
-      content_tag(:div, id: id, class: 'panel-body ' + klass, &block)
+      content_tag(
+        tag || config({ @config_type => :body }, :div),
+        id:    id,
+        class: "panel-body #{klass}",
+        data:  data,
+        aria:  aria,
+        &block
+      )
     end
 
     # Used to generate the footer component for the panel.
     #
-    # @param [Hash] args
-    # @option args [String]  :id    The ID of the element
-    # @option args [String]  :class Custom class for the component.
-    # @yieldreturn [String]
+    # @param  [Symbol|String|Hash|NilClass] tag_or_options
+    # @param  [Hash] opts
+    # @option opts [String] :id
+    # @option opts [String] :class
+    # @option opts [Hash]   :data
+    # @option opts [Hash]   :aria
+    # @return [String]
     #
-    def footer(args = {}, &block)
-      id    = args.fetch(:id, '')
+    def footer(tag_or_options = nil, opts = {}, &block)
+      tag, args = parse_tag_or_options(tag_or_options, opts)
+
+      id    = args.fetch(:id,    nil)
       klass = args.fetch(:class, '')
+      data  = args.fetch(:data,  {})
+      aria  = args.fetch(:aria,  {})
 
-      content_tag(:div, id: id, class: 'panel-footer ' + klass, &block)
+      content_tag(
+        tag || config({ @config_type => :footer }, :div),
+        id:    id,
+        class: "panel-footer #{klass}",
+        data:  data,
+        aria:  aria,
+        &block
+      )
     end
 
     # Used to render the html for the entire panel object.

data/lib/bootstrap3_helper/tabs/content.rb

@@ -34,7 +34,7 @@ module Bootstrap3Helper # :nodoc:
         klass  = args.fetch(:class, '')
         active = klass.include? 'active'
 
-        content = content_tag(
+        content_tag(
           :div,
           id:       name,
           class:    "tab-pane fade #{active ? 'in' : ''} #{klass}",

data/lib/bootstrap3_helper/tabs/dropdown.rb

@@ -21,7 +21,7 @@ module Bootstrap3Helper # :nodoc:
         super(template)
 
         @name    = name
-        @content = block || proc { '' } 
+        @content = block || proc { '' }
       end
 
       # rubocop:disable Metrics/MethodLength
@@ -76,7 +76,7 @@ module Bootstrap3Helper # :nodoc:
           data: { toggle: 'dropdown' }, aria: { expanded: false }
         )
 
-        content += content_tag :ul, id: @id, class: 'dropdown-menu ' do
+        content + content_tag(:ul, id: @id, class: 'dropdown-menu ') do
           @content.call(self)
         end
       end

data/lib/bootstrap3_helper/tabs/menu.rb

@@ -19,9 +19,9 @@ module Bootstrap3Helper # :nodoc:
       def initialize(template, args = {}, &block)
         super(template)
 
-        @id      = args.fetch(:id, nil)
+        @id      = args.fetch(:id,    nil)
         @class   = args.fetch(:class, '')
-        @type    = args.fetch(:type, :tabs)
+        @type    = args.fetch(:type,  :tabs)
         @content = block || proc { '' }
       end
 
@@ -40,12 +40,12 @@ module Bootstrap3Helper # :nodoc:
       # @yieldreturn [String]
       #
       def item(name, args = {})
-        id     = args.fetch(:id, nil)
-        data   = args.fetch(:data, nil)
+        id     = args.fetch(:id,    nil)
+        data   = args.fetch(:data,  nil)
         klass  = args.fetch(:class, '')
         active = klass.include? 'active'
 
-        li = content_tag(
+        content_tag(
           :li,
           id:    id,
           class: klass,
@@ -81,7 +81,7 @@ module Bootstrap3Helper # :nodoc:
         klass    = args.fetch(:class, '')
         dropdown = Tabs::Dropdown.new(@template, name, &block)
 
-        content = content_tag :li, id: id, class: 'dropdown' + klass, data: data do
+        content_tag :li, id: id, class: 'dropdown' + klass, data: data do
           dropdown.to_s.html_safe
         end
       end

data/lib/bootstrap3_helper/version.rb

@@ -1,3 +1,3 @@
 module Bootstrap3Helper
-  VERSION = '2.0.0'.freeze
+  VERSION = '3.0.0'.freeze
 end

data/lib/bootstrap3_helper.rb

@@ -1,4 +1,6 @@
 require 'bootstrap3_helper/version'
+require 'bootstrap3_helper/configuration'
+require 'bootstrap3_helper/initialize'
 
 # Implementation files
 require 'bootstrap3_helper/component'
@@ -17,66 +19,6 @@ require 'bootstrap3_helper/railtie'
 # common Bootstrap components.
 #
 module Bootstrap3Helper
-  # Allows you to rapidly build Panel components.
-  #
-  # @example Bootstrap Panel Component:
-  #   <%= panel_helper :primary do |p| %>
-  #     <%= p.header { "Some Title" }
-  #     <%= p.body class: 'custom-class', id: 'custom-id' do %>
-  #       //HTML or Ruby code here...
-  #     <% end %>
-  #     <%= p.footer do %>
-  #       //HTML or Ruby
-  #     <% end %>
-  #   <% end %>
-  #
-  # @param  [Symbol|String|Hash|NilClass] args
-  # @yieldparam [Panel] panel
-  # @return [String]
-  #
-  def panel_helper(*args, &block)
-    Panel.new(self, *args, &block)
-  end
-
-  # Creates an Alert component.
-  #
-  # @example Bootstrap Alert Component:
-  #   <%= alert_helper :danger, dismissble: true do %>
-  #     Something went wrong with your model data...
-  #   <% end %>
-  #
-  # @param  [Symbol|String|Hash|NilClass] args
-  # @yieldreturn [String]
-  # @return [String]
-  #
-  def alert_helper(*args, &block)
-    Alert.new(self, *args, &block)
-  end
-
-  # Creates an Callout component.
-  #
-  # @example Bootstrap Callout Component:
-  #   <%= callout_helper :danger %>
-  #     Some information that needs your attention...
-  #   <% end %>
-  #
-  # @param  [Symbol|String|Hash|NilClass] args
-  # @yieldreturn [String]
-  # @return [String]
-  #
-  def callout_helper(*args, &block)
-    Callout.new(self, *args, &block)
-  end
-
-  # Just a easy way of checking if the environment is a devbox
-  # or a server.
-  #
-  # @return [Boolean]
-  #
-  def host_is_dev_pc?
-    Rails.root.to_s.include?('home')
-  end
-
   # Easily build a bootstrap accordion group component.
   #
   # @note All the element ids and data attributes needed to make the javascript
@@ -84,6 +26,7 @@ module Bootstrap3Helper
   #   You don't need to worry about them.
   #
   # @example Bootstrap Accordion Group Component:
+  #   ```erb
   #   <%= accordion_group_helper do |group| %>
   #     <% group.accordion class: 'primary' do |accordion| %>
   #         <%= accordion.header { "accordion 1" } %>
@@ -104,18 +47,22 @@ module Bootstrap3Helper
   #         <% end %>
   #     <% end %>
   #   <% end %>
+  #   ```
   #
-  # @param  [Symbol|String|Hash|NilClass] args
+  # @param  [Hash] opts
+  # @option opts [String] :id
+  # @option opts [String] :class
   # @yieldparam [AccordionGroup] group
   # @return [String]
   #
-  def accordion_group_helper(*args, &block)
-    AccordionGroup.new(self, *args, &block)
+  def accordion_group_helper(opts = {}, &block)
+    AccordionGroup.new(self, opts, &block)
   end
 
   # Easily build a bootstrap accordion component
   #
   # @example Bootstrap Panel Component:
+  #   ```erb
   #   <%= accordion_helper class: 'primary' do |accordion| %>
   #       <%= accordion.header do %>
   #           <span class="something">This is the heading....</span>
@@ -124,8 +71,19 @@ module Bootstrap3Helper
   #           <p>This is the body of the accordion....</p>
   #       <% end %>
   #   <% end %>
+  #   ```
+  #
+  # @overload accordion_helper(context, opts)
+  #   @param  [Symbol|String] context - :primary, :danger etc
+  #   @param  [Hash] opts
+  #   @option opts [String] :id
+  #   @option opts [String] :class
+  #
+  # @overload accordion_helper(opts)
+  #   @param  [Hash] opts
+  #   @option opts [String] :id
+  #   @option opts [String] :class
   #
-  # @param  [Symbol|String|Hash|NilClass] args
   # @yieldparam [Accordion] accordion
   # @return [String]
   #
@@ -133,6 +91,59 @@ module Bootstrap3Helper
     Accordion.new(self, *args, &block)
   end
 
+  # Creates an Alert component.
+  #
+  # @example Bootstrap Alert Component:
+  #   ```erb
+  #   <%= alert_helper :danger, dismissble: true do %>
+  #     Something went wrong with your model data...
+  #   <% end %>
+  #   ```
+  #
+  # @overload alert_helper(context, opts)
+  #   @param  [Symbol|String] context - :primary, :danger etc
+  #   @param  [Hash] opts
+  #   @option opts [String]  :id
+  #   @option opts [String]  :class
+  #   @option opts [Boolean] :dismissible
+  #
+  # @overload alert_helper(opts)
+  #   @param  [Hash] opts
+  #   @option opts [String] :id
+  #   @option opts [String] :class
+  #
+  # @return [String]
+  #
+  def alert_helper(*args, &block)
+    Alert.new(self, *args, &block)
+  end
+
+  # Creates an Callout component.
+  #
+  # @example Bootstrap Callout Component:
+  #   ```erb
+  #   <%= callout_helper :danger %>
+  #     Some information that needs your attention...
+  #   <% end %>
+  #   ```
+  #
+  # @overload callout_helper(context, opts)
+  #   @param  [Symbol|String] context - :primary, :danger etc
+  #   @param  [Hash] opts
+  #   @option opts [String] :id
+  #   @option opts [String] :class
+  #
+  # @overload callout_helper(opts)
+  #   @param  [Hash] opts
+  #   @option opts [String] :id
+  #   @option opts [String] :class
+  #
+  # @return [String]
+  #
+  def callout_helper(*args, &block)
+    Callout.new(self, *args, &block)
+  end
+
   # Allows you to rapidly build bootstrap glyphs.
   #
   # @note Only supply the last part of the glyph makrup.
@@ -146,6 +157,42 @@ module Bootstrap3Helper
     content_tag :span, '', class: "glyphicon glyphicon-#{name}"
   end
 
+  # Allows you to rapidly build Panel components.
+  #
+  # @example Bootstrap Panel Component:
+  #   ```erb
+  #   <%= panel_helper :default do |p| %>
+  #     <%= p.header do %>
+  #       <%= p.title { 'Some random text here' } %>
+  #     <% end %>
+  #     <%= p.body do %>
+  #       //HTML & Ruby
+  #     <% end %>
+  #   <% end %>
+  #   ```
+  #
+  # @overload panel_helper(context, opts)
+  #   @param  [String|Symbol] context - :primary, :danger etc
+  #   @param  [Hash] opts
+  #   @option opts [String] :id
+  #   @option opts [String] :class
+  #   @option opts [Hash]   :data
+  #   @option opts [Hash]   :aria
+  #
+  # @overload panel_helper(opts)
+  #   @param  [Hash] opts
+  #   @option opts [String] :id
+  #   @option opts [String] :class
+  #   @option opts [Hash]   :data
+  #   @option opts [Hash]   :aria
+  #
+  # @yieldparam [Panel] panel
+  # @return [String]
+  #
+  def panel_helper(*args, &block)
+    Panel.new(self, *args, &block)
+  end
+
   # Used to rapidly build Tabs.
   #
   # @note On menu items - you can pass in either symbol or string for the link. If
@@ -156,42 +203,48 @@ module Bootstrap3Helper
   #   or a Tabs::Dropdown.
   #
   # @example Bootstrap Tabs Component:
-  #   <%= tabs_helper type: :pills do |menu, content| %>
-  #     <%= menu.item(:testing1, class: 'active') { ' Testing 1' } %>
-  #     <%= menu.item :testing2 %>
-  #     <%= menu.item(:testing3) { ' Testing 3' } %>
-  #     <%= menu.dropdown 'Testing Dropdown' do |dropdown| %>
-  #         <%= dropdown.item(:testing5 ) { 'Testing 5' } %>
-  #         <%= dropdown.item(:testing6 ) { 'Testing 6' } %>
-  #         <%= dropdown.item(:testing7 ) { 'Testing 7' } %>
-  #     <% end %>
-  # 
-  # 
-  #     <%= content.item :testing1, class: 'active' do %>
-  #         Testing 1 content
-  #     <% end %>
-  #     <%= content.item :testing2 do %>
-  #         Testing 2 content
-  #     <% end %>
-  #     <%= content.item :testing3 do %>
-  #         Testing 3 content
-  #     <% end %>
-  #     <%= content.item :testing5 do %>
-  #         Testing 5 content
-  #     <% end %>
-  #     <%= content.item :testing6 do %>
-  #         Testing 6 content
+  #   <%= tabs_helper type: :pills do |tabs| %>
+  #     <%= tabs.menu do |menu| %>
+  #       <%= menu.item(:testing1, class: 'active') { ' Testing 1' } %>
+  #       <%= menu.item :testing2 %>
+  #       <%= menu.item(:testing3) { ' Testing 3' } %>
+  #       <%= menu.dropdown 'Testing Dropdown' do |dropdown| %>
+  #           <%= dropdown.item(:testing5 ) { 'Testing 5' } %>
+  #           <%= dropdown.item(:testing6 ) { 'Testing 6' } %>
+  #           <%= dropdown.item(:testing7 ) { 'Testing 7' } %>
+  #       <% end %>
   #     <% end %>
-  #     <%= content.item :testing7 do %>
-  #         Testing 7 content
+  #
+  #     <%= tabs.content do |content| %>
+  #       <%= content.pane :testing1, class: 'active' do %>
+  #           Testing 1 content
+  #       <% end %>
+  #       <%= content.pane :testing2 do %>
+  #           Testing 2 content
+  #       <% end %>
+  #       <%= content.pane :testing3 do %>
+  #           Testing 3 content
+  #       <% end %>
+  #       <%= content.pane :testing5 do %>
+  #           Testing 5 content
+  #       <% end %>
+  #       <%= content.pane :testing6 do %>
+  #           Testing 6 content
+  #       <% end %>
+  #       <%= content.pane :testing7 do %>
+  #           Testing 7 content
+  #       <% end %>
   #     <% end %>
   #   <% end %>
   #
-  # @param  [Symbol|String|Hash|NilClass] args
+  # @param  [Hash] opts
+  # @option args [String|Symbol] :type
+  # @option args [String]        :id
+  # @option args [String]        :class
   # @yieldparam [Tabs] tabs
   # @return [String]
   #
-  def tabs_helper(args = {}, &block)
-    Tabs.new(self, args, &block)
+  def tabs_helper(opts = {}, &block)
+    Tabs.new(self, opts, &block)
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: bootstrap3_helper
 version: !ruby/object:Gem::Version
-  version: 2.0.0
+  version: 3.0.0
 platform: ruby
 authors:
 - Robert David
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-10-08 00:00:00.000000000 Z
+date: 2022-07-29 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails
@@ -66,6 +66,34 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: 5.2.4
+- !ruby/object:Gem::Dependency
+  name: redcarpet
+  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'
+- !ruby/object:Gem::Dependency
+  name: solargraph
+  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'
 - !ruby/object:Gem::Dependency
   name: sassc-rails
   requirement: !ruby/object:Gem::Requirement
@@ -111,6 +139,7 @@ files:
 - lib/bootstrap3_helper/callout.rb
 - lib/bootstrap3_helper/component.rb
 - lib/bootstrap3_helper/configuration.rb
+- lib/bootstrap3_helper/initialize.rb
 - lib/bootstrap3_helper/panel.rb
 - lib/bootstrap3_helper/railtie.rb
 - lib/bootstrap3_helper/tabs.rb
@@ -138,7 +167,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.1.3
+rubygems_version: 3.1.6
 signing_key: 
 specification_version: 4
 summary: Simple gem for rapidly building bootstrap 3 components