bh 1.1.1 → 1.2.0

data/lib/bh/classes/button.rb

@@ -0,0 +1,58 @@
+require 'bh/classes/base'
+
+module Bh
+  module Classes
+    class Button < Base
+      # @return [#to_s] the context-related class to assign to the button.
+      def context_class
+        Button.contexts[@options[:context]]
+      end
+
+      # @return [#to_s] the size-related class to assign to the alert box.
+      def size_class
+        Button.sizes[@options[:size]]
+      end
+
+      # @return [#to_s] the layout-related class to assign to the alert box.
+      def layout_class
+        Button.layouts[@options[:layout]]
+      end
+
+    private
+
+      # @return [Hash<Symbol, String>] the classes that Bootstrap requires to
+      #   append to buttons for each possible context.
+      def self.contexts
+        HashWithIndifferentAccess.new(:'btn-default').tap do |klass|
+          klass[:danger]  = :'btn-danger'
+          klass[:info]    = :'btn-info'
+          klass[:link]    = :'btn-link'
+          klass[:primary] = :'btn-primary'
+          klass[:success] = :'btn-success'
+          klass[:warning] = :'btn-warning'
+        end
+      end
+
+      # @return [Hash<Symbol, String>] the classes that Bootstrap requires to
+      #   append to buttons for each possible size.
+      def self.sizes
+        HashWithIndifferentAccess.new.tap do |klass|
+          klass[:extra_small] = :'btn-xs'
+          klass[:large]       = :'btn-lg'
+          klass[:lg]          = :'btn-lg'
+          klass[:sm]          = :'btn-sm'
+          klass[:small]       = :'btn-sm'
+          klass[:xs]          = :'btn-xs'
+        end
+      end
+
+      # @return [Hash<Symbol, String>] the classes that Bootstrap requires to
+      #   append to buttons for each possible layout.
+      def self.layouts
+        HashWithIndifferentAccess.new.tap do |klass|
+          klass[:block] = :'btn-block'
+        end
+      end
+    end
+  end
+end

data/lib/bh/classes/button_to.rb

@@ -0,0 +1,33 @@
+require 'bh/classes/button'
+
+module Bh
+  module Classes
+    class ButtonTo < Button
+      def initialize(app = nil, *args, &block)
+        @url = extract_url_from(*args, &block)
+        super
+      end
+
+      def append_button_class!(klass)
+        case Bh.framework
+          when :rails then append_class! klass
+          when :padrino, :middleman then append_class_to! :submit_options, klass
+        end
+      end
+
+      def append_form_class!(klass)
+        case Bh.framework
+          when :rails then append_class! klass, html_attributes, :form_class
+          when :padrino, :middleman then append_class! klass
+        end
+      end
+
+      def accepts_block?
+        case Bh.framework
+          when :rails then defined?(ActionView::VERSION) # only Rails >= 4
+          when :padrino, :middleman then true
+        end
+      end
+    end
+  end
+end

data/lib/bh/classes/cdn.rb

@@ -0,0 +1,35 @@
+require 'bh/classes/base'
+
+module Bh
+  module Classes
+    # @api private
+    class Cdn
+      # @note if unspecified, the version should match the latest available
+      #   version. If that's not the case, it's a bug and should be fixed.
+      def self.bootstrap(options = {})
+        options[:version] ||= '3.3.0'
+        cdn_asset options.merge(library: 'bootstrap')
+      end
+
+      # @note if unspecified, the version should match the latest available
+      #   version. If that's not the case, it's a bug and should be fixed.
+      def self.font_awesome(options = {})
+        options[:version] ||= '4.2.0'
+        cdn_asset options.merge(library: 'font-awesome')
+      end
+
+    private
+
+      def self.cdn_asset(options = {})
+        version = options[:version]
+        extension = options[:extension]
+        name = options[:name]
+        name = "#{name}.min" if options.fetch(:minified, true)
+        library = options[:library]
+        scheme = "#{options[:scheme]}:" if options[:scheme]
+        host = "#{scheme}//netdna.bootstrapcdn.com"
+        "#{host}/#{library}/#{version}/#{extension}/#{name}.#{extension}"
+      end
+    end
+  end
+end

data/lib/bh/classes/dropdown.rb

@@ -0,0 +1,56 @@
+require 'bh/classes/button'
+
+module Bh
+  module Classes
+    class Dropdown < Button
+      # @return [#to_s] the group-related class to assign to the dropdown.
+      def groupable_class
+        Dropdown.groupables[@options[:groupable]]
+      end
+
+      # @return [#to_s] the direction-related class to assign to the dropdown.
+      def direction_class
+        Dropdown.directions[@options[:direction]]
+      end
+
+      # @return [#to_s] the align-related class to assign to the dropdown.
+      def align_class
+        Dropdown.aligns[@options[:align]]
+      end
+
+      def id
+        @options.fetch :id, "dropdown-#{rand 10**10}"
+      end
+
+      def partial
+        @options[:split] ? 'dropdown_split' : 'dropdown'
+      end
+
+    private
+
+      # @return [Hash<Symbol, String>] the class that Bootstrap requires to
+      #   append to a dropdown to display it as inline or block.
+      def self.groupables
+        HashWithIndifferentAccess.new(:'btn-group').tap do |klass|
+          klass[false] = :dropdown
+        end
+      end
+
+      # @return [Hash<Symbol, String>] the class that Bootstrap requires to
+      #   append to a dropdown to show a drop-"up" or -"down".
+      def self.directions
+        HashWithIndifferentAccess.new.tap do |klass|
+          klass[:up] = :dropup
+        end
+      end
+
+      # @return [Hash<Symbol, String>] the class that Bootstrap requires to
+      #   append to a dropdown to left- or right- align to the toggle button.
+      def self.aligns
+        HashWithIndifferentAccess.new.tap do |klass|
+          klass[:right] = :'dropdown-menu-right'
+        end
+      end
+    end
+  end
+end

data/lib/bh/classes/icon.rb

@@ -0,0 +1,34 @@
+require 'bh/classes/base'
+
+module Bh
+  module Classes
+    # @api private
+    class Icon < Base
+      # @return [#to_s] the class to assign to the icon based on the Vector
+      #   Icon library used.
+      def library_class
+        Icon.libraries[@options[:library].to_s.underscore] || @options[:library]
+      end
+
+      # @return [#to_s] the class to assign to the icon based on the name
+      #   of the icon.
+      def name_class
+        if name = @options[:name]
+          "#{library_class}-#{name.to_s.gsub '_', '-'}" 
+        end
+      end
+
+    private
+
+      # @return [Hash<Symbol, String>] the classes that Bootstrap requires to
+      #   append to icons for each possible vector icon library.
+      def self.libraries
+        HashWithIndifferentAccess.new(nil).tap do |klass|
+          klass[:font_awesome]  = :'fa'
+          klass[:glyphicons]    = :'glyphicon'
+          klass[:'']            = :'glyphicon'
+        end
+      end
+    end
+  end
+end

data/lib/bh/classes/link_to.rb

@@ -0,0 +1,22 @@
+require 'bh/classes/base'
+
+module Bh
+  module Classes
+    class LinkTo < Base
+      def initialize(app = nil, *args, &block)
+        @url = extract_url_from(*args, &block)
+        super
+      end
+
+      def current_page?
+        case Bh.framework
+        when :rails
+          @app.current_page? @url
+        when :padrino, :middleman
+          request = Bh.framework == :middleman ? @app.req : @app.request
+          request.path_info == @app.url_for(@url)
+        end
+      end
+    end
+  end
+end

data/lib/bh/classes/modal.rb

@@ -0,0 +1,68 @@
+require 'bh/classes/button'
+
+module Bh
+  module Classes
+    class Modal < Base
+      # Differently from other classes, Modal works with no content or block,
+      # given that the options[:body] is passed, in which case it functions
+      # as the content.
+      def initialize(app = nil, *args, &block)
+        if args.first.is_a?(Hash) && !block_given?
+          args.unshift args.first.delete(:body)
+        end
+
+        super
+      end
+
+      # @return [#to_s] the context-related class to assign to the modal button.
+      def button_context_class
+        Button.contexts[@options.fetch(:button, {})[:context]]
+      end
+
+      # @return [#to_s] the size-related class to assign to the modal button.
+      def button_size_class
+        Button.sizes[@options.fetch(:button, {})[:size]]
+      end
+
+      # @return [#to_s] the size-related class to assign to the modal dialog.
+      def dialog_size_class
+        Modal.dialog_sizes[@options[:size]]
+      end
+
+      # @return [#to_s] the caption for the modal button.
+      def caption
+        @options.fetch(:button, {}).fetch :caption, title
+      end
+
+      # @return [#to_s] the title to display on top of the modal dialog.
+      def title
+        @options.fetch :title, 'Modal'
+      end
+
+      def id
+        @options.fetch :id, "modal-#{rand 10**10}"
+      end
+
+    private
+
+      # @return [Hash<Symbol, String>] the classes that Bootstrap requires to
+      #   append to the modal dialog for each possible size.
+      def self.dialog_sizes
+        HashWithIndifferentAccess.new.tap do |klass|
+          klass[:large]       = :'modal-lg'
+          klass[:lg]          = :'modal-lg'
+          klass[:sm]          = :'modal-sm'
+          klass[:small]       = :'modal-sm'
+        end
+      end
+
+      def extract_content_from(*args, &block)
+        if block_given?
+          super
+        else
+          @app.content_tag :div, super, class: 'modal-body'
+        end
+      end
+    end
+  end
+end

data/lib/bh/classes/nav.rb

@@ -0,0 +1,37 @@
+require 'bh/classes/base'
+
+module Bh
+  module Classes
+    # @api private
+    class Nav < Base
+      # @return [#to_s] the style-related class to assign to the nav.
+      def style_class
+        Nav.styles[@options[:as]]
+      end
+
+      # @return [#to_s] the layout-related class to assign to the nav.
+      def layout_class
+        Nav.layouts[@options[:layout]]
+      end
+
+    private
+
+      # @return [Hash<Symbol, String>] the classes that Bootstrap requires to
+      #   append to navs for each possible style.
+      def self.styles
+        HashWithIndifferentAccess.new(:'nav-tabs').tap do |klass|
+          klass[:pills] = :'nav-pills'
+        end
+      end
+
+      # @return [Hash<Symbol, String>] the classes that Bootstrap requires to
+      #   append to buttons for each possible layout.
+      def self.layouts
+        HashWithIndifferentAccess.new.tap do |klass|
+          klass[:justified] = :'nav-justified'
+          klass[:stacked]   = :'nav-stacked'
+        end
+      end
+    end
+  end
+end

data/lib/bh/classes/navbar.rb

@@ -0,0 +1,78 @@
+require 'bh/classes/base'
+
+module Bh
+  module Classes
+    class Navbar < Base
+      # @return [#to_s] the style-related class to assign to the navbar.
+      def style_class
+        Navbar.styles[@options[:inverted]]
+      end
+
+      # @return [#to_s] the position-related class to assign to the navbar.
+      def position_class
+        Navbar.positions[@options[:position]]
+      end
+
+      # @return [#to_s] the layout-related class to assign to the navbar.
+      def layout_class
+        Navbar.layouts[@options[:fluid]]
+      end
+
+      def id
+        @id ||= @options.fetch :id, "navbar-collapse-#{rand 10**10}"
+      end
+
+      # @private
+      # The fixed navbar will overlay your other content, unless you add padding
+      # to the top or bottom of the <body>. Try out your own values or use our
+      # snippet below. Tip: By default, the navbar is 50px high.
+      # @see http://getbootstrap.com/components/#navbar-fixed-top
+      def body_padding_style
+        if body_padding_amount && body_padding_type
+          style = "padding-#{body_padding_type}: #{body_padding_amount}px"
+          @app.content_tag :style, "body {#{style}}"
+        end
+      end
+
+    private
+
+      # @return [Hash<Symbol, String>] the classes that Bootstrap requires to
+      #   append to navbars to specify a color combination.
+      def self.styles
+        HashWithIndifferentAccess.new(:'navbar-default').tap do |klass|
+          klass[true] = :'navbar-inverse'
+        end
+      end
+
+      # @return [Hash<Symbol, String>] the classes that Bootstrap requires to
+      #   append to navbars to set a specific DOM position.
+      def self.positions
+        HashWithIndifferentAccess.new.tap do |klass|
+          klass[:static]        = :'navbar-static-top'
+          klass[:static_top]    = :'navbar-static-top'
+          klass[:top]           = :'navbar-fixed-top'
+          klass[:fixed_top]     = :'navbar-fixed-top'
+          klass[:bottom]        = :'navbar-fixed-bottom'
+          klass[:fixed_bottom]  = :'navbar-fixed-bottom'
+        end
+      end
+
+      # @return [Hash<Symbol, String>] the classes that Bootstrap requires to
+      #   append to the navbar container for each possible layout.
+      def self.layouts
+        HashWithIndifferentAccess.new(:'container').tap do |klass|
+          klass[true] = :'container-fluid'
+        end
+      end
+
+      def body_padding_amount
+        @options.fetch :padding, 70
+      end
+
+      def body_padding_type
+        /navbar-fixed-(?<type>top|bottom)$/ =~ position_class
+        type
+      end
+    end
+  end
+end

data/lib/bh/classes/panel.rb

@@ -0,0 +1,72 @@
+require 'bh/classes/base'
+
+module Bh
+  module Classes
+    class Panel < Base
+      # Differently from other classes, Panel works with no content or block,
+      # given that the options[:body] is passed, in which case it functions
+      # as the content.
+      def initialize(app = nil, *args, &block)
+        if args.first.is_a?(Hash) && !block_given?
+          args.unshift args.first.delete(:body)
+        end
+
+        super
+      end
+
+      # @return [#to_s] the content-related class to assign to the panel.
+      def context_class
+        Panel.contexts[@options[:context]]
+      end
+
+      # @return [#to_s] the HTML tag to wrap the panel in.
+      def tag
+        @options.fetch :tag, :div
+      end
+
+      # @return [#to_s] the text to display as the panel header
+      def heading
+        text = title || @options[:heading]
+        @app.content_tag :div, text, class: 'panel-heading' if text
+      end
+
+      def merge_html!(html)
+        @content ||= html
+      end
+
+      def body
+        if @options[:body]
+          @app.content_tag :div, @options[:body], class: 'panel-body'
+        end
+      end
+
+    private
+
+      def extract_content_from(*args, &block)
+        if block_given?
+          super
+        else
+          @app.content_tag :div, super, class: 'panel-body'
+        end
+      end
+
+      def title
+        if @options[:title]
+          @app.content_tag :h3, @options[:title], class: 'panel-title'
+        end
+      end
+
+      # @return [Hash<Symbol, String>] the class that Bootstrap requires to
+      #   append to an panel box based on its context.
+      def self.contexts
+        HashWithIndifferentAccess.new(:'panel-default').tap do |klass|
+          klass[:primary]   = :'panel-primary'
+          klass[:success] = :'panel-success'
+          klass[:info]    = :'panel-info'
+          klass[:warning] = :'panel-warning'
+          klass[:danger]  = :'panel-danger'
+        end
+      end
+    end
+  end
+end