bootstrap4_rails_components 0.1.0

data/lib/bootstrap4_rails_components/bootstrap/components/pagination.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+module Bootstrap4RailsComponents
+  module Bootstrap
+    module Components
+      # Bootstrap Pagination Component
+      # https://getbootstrap.com/docs/4.1/components/pagination/
+      class Pagination < Bootstrap4RailsComponents::Bootstrap::Components::Base
+        include Bootstrap::Utilities::Alignable
+        include Bootstrap::Utilities::Sizable
+
+        def component_family
+          :pagination
+        end
+
+        def render
+          content_tag(:nav) do
+            super
+          end
+        end
+
+        private
+
+        def base_element
+          :ul
+        end
+      end
+    end
+  end
+end

data/lib/bootstrap4_rails_components/bootstrap/components/popover.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module Bootstrap4RailsComponents
+  module Bootstrap
+    module Components
+      # Bootstrap Popover Component
+      # https://getbootstrap.com/docs/4.1/components/popovers/
+      class Popover < Bootstrap4RailsComponents::Bootstrap::Components::Base
+      end
+    end
+  end
+end

data/lib/bootstrap4_rails_components/bootstrap/components/progress.rb

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+
+module Bootstrap4RailsComponents
+  module Bootstrap
+    module Components
+      # Bootstrap Parent Progress Component
+      # https://getbootstrap.com/docs/4.1/components/progress/
+      class Progress < Bootstrap4RailsComponents::Bootstrap::Components::Base
+        include Bootstrap::Utilities::Progressable
+
+        def component_family
+          :progress
+        end
+
+        def height
+          options.fetch(:height, nil)
+        end
+
+        def style
+          [
+            super,
+            ("height: #{height}px;" if height)
+          ].join(' ').squish
+        end
+
+        def render
+          super do
+            if body
+              (block_given? ? yield : body)
+            else
+              Bootstrap4RailsComponents::Bootstrap::Components::ProgressBar.new({ theme: theme, label: label, progress: progress, striped: striped, animated: animated }, view_context).render
+            end
+          end
+        end
+
+        private
+
+        def non_html_attribute_options
+          super.push(:height)
+        end
+      end
+    end
+  end
+end

data/lib/bootstrap4_rails_components/bootstrap/components/progress_bar.rb

@@ -0,0 +1,51 @@
+# frozen_string_literal: true
+
+module Bootstrap4RailsComponents
+  module Bootstrap
+    module Components
+      # Bootstrap Progress Bar Component
+      # https://getbootstrap.com/docs/4.1/components/progress/
+      class ProgressBar < Bootstrap4RailsComponents::Bootstrap::Components::Progress
+        include Bootstrap::Utilities::Progressable
+        include Bootstrap::Utilities::Themeable
+
+        def component_family
+          :progress
+        end
+
+        def style
+          [
+            options[:style],
+            ("width: #{progress.to_i}%;" if progress)
+          ].join(' ').squish
+        end
+
+        def render
+          content_tag(:div, label, html_options)
+        end
+
+        private
+
+        def css_classes
+          [
+            super,
+            ("#{component_css_class}-striped" if striped),
+            ("#{component_css_class}-animated" if animated)
+          ].join(' ').squish
+        end
+
+        def assistive_html_attributes
+          super.merge!(role: 'progressbar', aria: { valuenow: progress, valuemin: 0, valuemax: 100 })
+        end
+
+        def theme_css_class_prefix
+          'bg-'
+        end
+
+        def outlineable?
+          false
+        end
+      end
+    end
+  end
+end

data/lib/bootstrap4_rails_components/bootstrap/components/tab_content.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module Bootstrap4RailsComponents
+  module Bootstrap
+    module Components
+      # Bootstrap Progress Component
+      # https://getbootstrap.com/docs/4.1/components/progress/
+      class TabContent < Bootstrap4RailsComponents::Bootstrap::Components::Base
+        def component_family
+          :tab
+        end
+      end
+    end
+  end
+end

data/lib/bootstrap4_rails_components/bootstrap/components/tab_pane.rb

@@ -0,0 +1,49 @@
+# frozen_string_literal: true
+
+module Bootstrap4RailsComponents
+  module Bootstrap
+    module Components
+      # Bootstrap Progress Component
+      # https://getbootstrap.com/docs/4.1/components/progress/
+      class TabPane < Bootstrap4RailsComponents::Bootstrap::Components::Base
+        include Bootstrap::Utilities::Activatable
+
+        def component_family
+          :tab
+        end
+
+        def tab
+          options.fetch(:tab, nil)
+        end
+
+        def id
+          tab ? tab.tr('#', '') : super
+        end
+
+        # Fade is turned on by default
+        # This should probably be a global setting
+        def fade
+          options.fetch(:fade, true)
+        end
+
+        private
+
+        def css_classes
+          [
+            super,
+            ('fade' if fade),
+            ('show' if active)
+          ].join(' ').squish
+        end
+
+        def non_html_attribute_options
+          super.push(:tab)
+        end
+
+        def assistive_html_attributes
+          { role: 'tabpanel' }
+        end
+      end
+    end
+  end
+end

data/lib/bootstrap4_rails_components/bootstrap/components/table.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module Bootstrap4RailsComponents
+  module Bootstrap
+    module Components
+      # Bootstrap Table Component
+      # https://getbootstrap.com/docs/4.1/content/tables/
+      class Table < Bootstrap4RailsComponents::Bootstrap::Components::Base
+        private
+
+        def base_element
+          :table
+        end
+      end
+    end
+  end
+end

data/lib/bootstrap4_rails_components/bootstrap/readme.md

@@ -0,0 +1 @@
+Bootstrap4 code will be isolated into its own gem later.

data/lib/bootstrap4_rails_components/bootstrap/utilities/activatable.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+module Bootstrap4RailsComponents
+  module Bootstrap
+    module Utilities
+      # Passes in necessary attributes to allow a component to have an active state
+      module Activatable
+
+        def active
+          options.fetch(:active, default_active)
+        end
+
+        private
+
+        def css_classes
+          [
+            super,
+            ('active' if active)
+          ].join(' ').squish
+        end
+
+        def non_html_attribute_options
+          super.push(:active)
+        end
+
+        def default_active
+          false
+        end
+      end
+    end
+  end
+end

data/lib/bootstrap4_rails_components/bootstrap/utilities/alignable.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+module Bootstrap4RailsComponents
+  module Bootstrap
+    module Utilities
+      # Allow components to be right and center aligned
+      module Alignable
+        def center
+          options.fetch(:center, false)
+        end
+
+        def right
+          options.fetch(:right, false)
+        end
+
+        private
+
+        def css_classes
+          [
+            super,
+            ('justify-content-center' if center),
+            ('justify-content-end' if right)
+          ].join(' ').squish
+        end
+
+        def non_html_attribute_options
+          super.push(:right,
+                     :center)
+        end
+      end
+    end
+  end
+end

data/lib/bootstrap4_rails_components/bootstrap/utilities/collapse_toggleable.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+module Bootstrap4RailsComponents
+  module Bootstrap
+    module Utilities
+      # Allows components to have a collapsed state when appropriate
+      module CollapseToggleable
+        include Bootstrap::Utilities::Collapsible
+
+        def data
+          collapse ? super.merge!(collapse_data_attributes) : super
+        end
+
+        private
+
+        # Buttons need to be able to to set a target on :buttons
+        # and an href on links -- so this attribute is customizable if needed
+        def collapse_data_attributes
+          @collapse_data_attributes ||= { toggle: 'collapse', target: collapse }
+        end
+
+        # To do: currently collapsible doesn't control the actual collapse
+        # As such, there's no way to set aria-expanded on the button / toggle...
+        # based on whether or not the collapse component is expanded or not
+        #
+        # To solve: how to address aria-expanded to accurately reflect the expanded status
+        def assistive_html_attributes
+          return super unless collapse
+          super.merge!(aria: (options[:aria] || {}).merge!(expanded: 'false', controls: collapse.tr('#','')),
+                       role: 'button')
+        end
+      end
+    end
+  end
+end

data/lib/bootstrap4_rails_components/bootstrap/utilities/collapsible.rb

@@ -0,0 +1,42 @@
+# frozen_string_literal: true
+
+module Bootstrap4RailsComponents
+  module Bootstrap
+    module Utilities
+      # Allows components to carry collapse attributes
+      # to more easily pass collapse status to a collapsible target
+      #
+      # Example:
+      # Tile & TileHeader both include Collapsible
+      # because they both pass collapse attributes to
+      # a collapse button within TileHeader
+      #
+      # They do not, however need a collapse toggle
+      # unlike a NavbarToggle / Button, and thus they do not include
+      # The CollapseToggleable module
+      #
+      # CollapseToggleable components have this module included
+      # by default via the CollapseToggleable module.
+      module Collapsible
+        def collapse
+          options.fetch(:collapse, nil)
+        end
+
+        def collapsed
+          options.fetch(:collapsed, nil)
+        end
+
+        # Collapsible checks if collapse is manually set true or false and thus, collapsible
+        def collapsible
+          options[:collapsible] || collapse || !collapsed.nil?
+        end
+
+        private
+
+        def non_html_attribute_options
+          super.push(:collapse, :collapsed, :collapsible)
+        end
+      end
+    end
+  end
+end

data/lib/bootstrap4_rails_components/bootstrap/utilities/disableable.rb

@@ -0,0 +1,49 @@
+# frozen_string_literal: true
+
+module Bootstrap4RailsComponents
+  module Bootstrap
+    module Utilities
+      # Allows components to have a disabled state when appropriate
+      module Disableable
+        attr_reader :as
+
+        def disabled
+          options.fetch(:disabled, false)
+        end
+
+        private
+
+        def css_classes
+          # when the tag does not take a disabled attribute we
+          # assigne the disabled class
+          [
+            super,
+            ('disabled' if disabled && !tag_allows_for_disable_attribute?)
+          ].join(' ').squish
+        end
+
+        def non_html_attribute_options
+          # if tag accepts the disabled attribute
+          # push it through, otherwise remove it from the
+          # html options. We do this regardless of whether or not
+          # disabled was actually set to ensure that those
+          # tags that can't take a disabled option never receive it
+          tag_allows_for_disable_attribute? ? super : super.push(:disabled)
+        end
+
+        def assistive_html_attributes
+          if disabled
+            super.merge!(tabindex: '-1',
+                         **(tag_allows_for_disable_attribute?) ? { disabled: true } : {})
+          else
+            super
+          end
+        end
+
+        def tag_allows_for_disable_attribute?
+          [:button, :input, :fieldset, :optgroup, :option, :select, :textarea].include?(as)
+        end
+      end
+    end
+  end
+end

data/lib/bootstrap4_rails_components/bootstrap/utilities/dismissible.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+module Bootstrap4RailsComponents
+  module Bootstrap
+    module Utilities
+      # Delivers the dismissibility of the component to the HAML partial
+      module Dismissible
+        def dismissible
+          options.fetch(:dismissible, default_dismissible)
+        end
+
+        private
+
+        def non_html_attribute_options
+          super.push(:dismissible)
+        end
+
+        def default_dismissible
+          true
+        end
+      end
+    end
+  end
+end