bootstrap4_helper 1.0.0 → 1.0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f0b8c171fc1cd2510c422ae2e359386eac13e14a11437674208960480d35167b
-  data.tar.gz: 7779d13c5a369aec5c1b15b10916e78a197cb3d7a3d31b1bc3284dedb1376563
+  metadata.gz: ecce74ed3cfecf92336b00a39382a3f08421677a5d19960c9258d75b408ff3ae
+  data.tar.gz: 502e141e6a43ff40a0b5c1d3b5df7a6595de3ba8d9cb87b1cbb24036f2b919e6
 SHA512:
-  metadata.gz: fccc06d01e6e46ee9e33d67d1842705a87567dab8d8ac6d6dbce18449e478d9353937cb14ab1887b3fce71e34528c1462014f5e22531b1e7e7ee8ea9c60def9a
-  data.tar.gz: b2574bbfd27950f1bec5234a09937f78570b9cd41a0a7cbab02c8e3f79c1d126b5140a5daf38897a684fd488bae7e5f9ca7ef5364d656d343d5b8269d6b79a6c
+  metadata.gz: 3638e8d509347594f2e5491a5a3ebd024795f0dce99113946b656e029f1e5c27ef4fb019c45949b0954c010fe90b3485d8f630f34f7025b09d34395f5cf4565d
+  data.tar.gz: f352adbb8fdc083faf28e2bce76e3f7763c208c4d00fd328532a9e24fafe4fcf324d05ab3c96389ecc7c3ac4c4d00134d5a3acfa77b3bf8f188ebc9270e1d597

data/README.md

@@ -1,10 +1,13 @@
 # Bootstrap4Helper
+
 Short description and motivation.
 
 ## Usage
+
 How to use my plugin.
 
 ## Installation
+
 Add this line to your application's Gemfile:
 
 ```ruby
@@ -12,17 +15,21 @@ gem 'bootstrap4_helper'
 ```
 
 And then execute:
+
 ```bash
 $ bundle
 ```
 
 Or install it yourself as:
+
 ```bash
 $ gem install bootstrap4_helper
 ```
 
 ## Contributing
+
 Contribution directions go here.
 
 ## License
+
 The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).

data/lib/bootstrap4_helper.rb

@@ -8,19 +8,16 @@ end
 
 require 'bootstrap4_helper/initialize'
 
-# @todo
-# - We need a configuration system so people can specify what DOM elements to
-# use when building components.  Like, so we want <h1> for Card Headers or just
-# <div>'s.
+# This is the module that will get included in your partials.
+#
 #
 module Bootstrap4Helper
-  # @description
-  # - Creates a single Accordion element.  The header component
+  # Creates a single Accordion element.  The header component
   # already provides the DOM element to link the Collapse area.
   # You just need to provide the text or additional markup, if
   # you want it.
   #
-  # <code>
+  # ```erb
   #  <%= accordion_helper do |a| %>
   #    <%= a.header do %>
   #      // Some HTML or Ruby
@@ -29,20 +26,19 @@ module Bootstrap4Helper
   #      // Some HTML or Ruby
   #    <% end %>
   #  <% end %>
-  # </code>
+  # ```
   #
-  # @param [Mixed] args
+  # @param  [Hash] opts
   # @return [Accordion]
   #
   def accordion_helper(opts = {}, &block)
     Accordion.new(self, opts, &block)
   end
 
-  # @description
-  # - Creates a group of Accordions that stay in sync with each other.
+  # Creates a group of Accordions that stay in sync with each other.
   # One opens, the other closes.
   #
-  # <code>
+  # ```erb
   #  <%= accordion_group_helper do |grp| %>
   #    <%= grp.accordion do |a| %>
   #      <%= a.header class: 'text-white bg-primary' do %>
@@ -62,58 +58,55 @@ module Bootstrap4Helper
   #      <% end %>
   #    <% end %>
   #  <% end $>
-  # </code>
+  # ```
   #
-  # @param [Mixed] args
+  # @param  [Mixed] args
   # @return [Accordion]
   #
   def accordion_group_helper(*args, &block)
     AccordionGroup.new(self, *args, &block)
   end
 
-  # @description
-  # - Creates an Alert component.
+  # Creates an Alert component.
   #
-  # <code>
+  # ```erb
   #   <%= alert_helper :danger, dismissble: true do %>
   #     Something went wrong with your model data...
   #   <% end %>
-  # </code>
+  # ```
   #
-  # @params [Symbol|String|Hash|NilClass] *args
+  # @param  [Mixed] args
   # @return [String]
   #
   def alert_helper(*args, &block)
     Alert.new(self, *args, &block)
   end
 
-  # @description
-  # - Creates a badge component.  Bades have a context variable.  Providing nothing
+  # Creates a badge component.  Bades have a context variable.  Providing nothing
   # will give you the `secondary` context.
   #
-  # <code>
+  # ```erb
   #  <li>
   #    Messages: <%= badge_helper(:primary) { @messages.count } %>
   #  </li>
   #  <li>
   #    Notifications: <%= badge_healper { @notifications.count } %>
   #  </li>
-  # </code>
+  # ```
   #
-  # @params [Symbol|String|Hash|NilClass] *args
+  # @param  [Mixed] args
   # @return [String]
   #
   def badge_helper(*args, &block)
     Badge.new(self, *args, &block)
   end
 
-  # @description
-  # - Creates a Card component.
+  # Creates a Card component.
   #
   #
-  # <code>
+  # ```erb
   #
-  # - Regular
+  # <%# Regular %>
   #
   #   <%= card_helper do |c| %>
   #     <%= c.header class: 'text-white bg-primary' do %>
@@ -133,7 +126,7 @@ module Bootstrap4Helper
   #     <% end %>
   #   <% end %>
   #
-  # - Horizontal
+  # <%# Horizontal %>
   #
   #  <div class="row">
   #    <div class="col-sm mt-3 mb-3">
@@ -155,19 +148,18 @@ module Bootstrap4Helper
   #        <% end %>
   #    </div>
   #  </div>
-  # </code>
+  # ```
   #
-  # @param [Hash] opts
+  # @param  [Hash] opts
   # @return [String]
   #
   def card_helper(opts = {}, &block)
     Card.new(self, opts, &block)
   end
 
-  # @description
-  # - Builds a card group.
+  # Builds a card group.
   #
-  # <code>
+  # ```erb
   #  <%= card_group_helper do |group| %>
   #    <%= group.card do |c| %>
   #        <%= c.body do %>
@@ -214,19 +206,18 @@ module Bootstrap4Helper
   #        <% end %>
   #    <% end %>
   #  <% end %>
-  # </code>
+  # ```
   #
-  # @param [Hash] opts
+  # @param  [Hash] opts
   # @return [String]
   #
   def card_group_helper(opts = {}, &block)
     CardGroup.new(self, opts, &block)
   end
 
-  # @description
-  # - Builds a card deck.
+  # Builds a card deck.
   #
-  # <code>
+  # ```erb
   #  <%= card_deck_helper do |deck| %>
   #    <%= deck.card do |c| %>
   #        <%= c.body do %>
@@ -273,19 +264,18 @@ module Bootstrap4Helper
   #        <% end %>
   #    <% end %>
   #  <% end %>
-  # </code>
+  # ```
   #
-  # @param [Hash] opts
+  # @param  [Hash] opts
   # @return [String]
   #
   def card_deck_helper(opts = {}, &block)
     CardDeck.new(self, opts, &block)
   end
 
-  # @description
-  # - Builds a card column.
+  # Builds a card column.
   #
-  # <code>
+  # ```erb
   #  <%= card_column_helper do |column| %>
   #    <%= column.card do |c| %>
   #        <%= c.body do %>
@@ -332,20 +322,19 @@ module Bootstrap4Helper
   #        <% end %>
   #    <% end %>
   #  <% end %>
-  # </code>
+  # ```
   #
-  # @param [Hash] opts
+  # @param  [Hash] opts
   # @return [String]
   #
   def card_column_helper(opts = {}, &block)
     CardColumn.new(self, opts, &block)
   end
 
-  # @description
-  # - Generates a Dropdown component.  Default type `:dropdown`.  For inline buttons, use
+  # Generates a Dropdown component.  Default type `:dropdown`.  For inline buttons, use
   # `:group`.
   #
-  # <code>
+  # ```erb
   #  <%= dropdown_helper do |dropdown| %>
   #    <%= dropdown.button(:primary) { "Action" } %>
   #    <%= dropdown.menu do |menu| %>
@@ -395,19 +384,18 @@ module Bootstrap4Helper
   #        <%= menu.link "Forgot password", "#" %>
   #    <% end %>
   #  <% end %>
-  # </code>
+  # ```
   #
-  # @param [Mixed] args
+  # @param  [Mixed] args
   # @return [String]
   #
   def dropdown_helper(*args, &block)
     Dropdown.new(self, *args, &block)
   end
 
-  # @description
-  # - Generates Modal windows.
+  # Generates Modal windows.
   #
-  # <code>
+  # ```erb
   #  <%= modal_helper id: 'exampleModal' do |m| %>
   #    <%= m.header do %>
   #        <%= m.title { 'Example Modal' } %>
@@ -425,19 +413,18 @@ module Bootstrap4Helper
   #        <% end %>
   #    <% end %>
   #  <% end %>
-  # </code>
+  # ```
   #
-  # @param [Hash] opts
+  # @param  [Hash] opts
   # @return [String]
   #
   def modal_helper(opts = {}, &block)
     Modal.new(self, opts, &block)
   end
 
-  # @description
-  # - Generates Nav components.
+  # Generates Nav components.
   #
-  # <code>
+  # ```erb
   #  <%= nav_helper do |nav| %>
   #    <%= nav.link "Item 1", "https://www.google.com" %>
   #    <%= nav.link "Item 2", "#" %>
@@ -452,19 +439,18 @@ module Bootstrap4Helper
   #        <%= menu.link 'Records', '#' %>
   #    <% end %>
   #  <% end %>
-  # </code>
+  # ```
   #
-  # @param [Hash] opts
+  # @param  [Hash] opts
   # @return [String]
   #
   def nav_helper(opts = {}, &block)
     Nav.new(self, opts, &block)
   end
 
-  # @description
-  # - Generates a Tab component.
+  # Generates a Tab component.
   #
-  # <code>
+  # ```erb
   #  <%= tab_helper do |tab| %>
   #    <%= tab.nav do |nav| %>
   #        <%= nav.item :item1 do %>
@@ -505,19 +491,22 @@ module Bootstrap4Helper
   #        <% end %>
   #    <% end %>
   #  <% end %>
-  # </code>
+  # ```
+  # @param  [Mixed] args
+  # @return [String]
   #
   def tab_helper(*args, &block)
     Tab.new(self, *args, &block)
   end
 
-  # @description
-  # - Generates spinner annimations.
+  # Generates spinner annimations.
   #
-  # <code>
+  # ```erb
   #  <%= spinner_helper class: 'text-warning' %>
   #  <%= spinner_helper type: :grow, class: 'text-danger', id: 'loadingRecords' %>
-  # </code>
+  # ```
+  # @param  [Mixed] args
+  # @return [String]
   #
   def spinner_helper(*args, &block)
     Spinner.new(self, *args, &block)

data/lib/bootstrap4_helper/accordion.rb

@@ -1,9 +1,6 @@
-# @root
-#
-#
 module Bootstrap4Helper
-  # @description
-  # - Builds a Accordion out of the collapse component of Bootstrap 4.
+  # Builds a Accordion out of the collapse component of Bootstrap 4.
+  #
   #
   class Accordion < Component
     CARD_METHODS = %i[
@@ -12,11 +9,16 @@ module Bootstrap4Helper
       image_overlay
     ].freeze
 
-    # @description
+    # Class constructor
     # -
     #
     # @param [ActionView] template
     # @param [Hash] opts
+    # @option opts [String] :id
+    # @option opts [String] :class
+    # @option opts [Hash]   :data
+    # @option opts [String] :parent
+    # @option opts [String] :target
     #
     def initialize(template, opts = {}, &block)
       super(template)
@@ -30,11 +32,10 @@ module Bootstrap4Helper
       @card    = Card.new(@template)
     end
 
-    # @description
-    # - Builds a header component for the accordion, which is actually the header
+    # Builds a header component for the accordion, which is actually the header
     # of a Card.
     #
-    # @param [Hash] opts
+    # @param  [Hash] opts
     # @return [String]
     #
     def header(opts = {}, &block)
@@ -49,15 +50,13 @@ module Bootstrap4Helper
       end
     end
 
-    # @description
-    # - Builds the body component for the accordion, which is actually the body
+    # Builds the body component for the accordion, which is actually the body
     # of a Card.
     #
-    # @note
-    # - The `@parent` gets used to set the parent element for the accordion. This
-    # gets used primarily in the `AccordionGroup`.
+    # @note The `@parent` gets used to set the parent element for the accordion. This
+    #   gets used primarily in the `AccordionGroup`.
     #
-    # @param [Hash] opts
+    # @param  [Hash] opts
     # @return [String]
     #
     def body(opts = {}, &block)
@@ -68,8 +67,7 @@ module Bootstrap4Helper
       end
     end
 
-    # @description
-    # - Because Accordions are basically `Cards` with a wrapper, we might as
+    # Because Accordions are basically `Cards` with a wrapper, we might as
     # well catch common `Card` methods and send them to the card object.  No
     # point in creating similar methods for `Accordions`.
     #
@@ -84,15 +82,14 @@ module Bootstrap4Helper
       end
     end
 
-    # @description
-    # -
+    # Checks if the Object reponds to missing. 
+    #
     #
     def respond_to_missing?(method, include_private = false)
       CARD_METHODS.include?(method) || super
     end
 
-    # @description
-    # - Leaving off the the default `accordion` class because with only 1 accordion,
+    # Leaving off the default `accordion` class because with only 1 accordion,
     # there is no bottom.
     #
     # @return [String]