class Bootstrap3Helper::Component

This super class is meant to contain commonly used methods that all sub classes can leverage.

@note Every component that inherits from this class, needs to call the parent

initialization method! In order to properly render erb blocks within the
proper context, we need the template. The only way to get this, is to pass
in the template.

@note The `context` mentioned above, refers to the context of `@template` and

not to be confused with `@context` that can be found in the sub classes.
`@context` refers to the Bootstrap class context of the component.

Public Class Methods

new(template) click to toggle source

Used to ensure that the helpers always have the propert context for rendering and bindings.

@param [Class] template - the context of the bindings

# File lib/bootstrap3_helper/component.rb, line 20
def initialize(template)
  @template = template
end

Public Instance Methods

concat(text) click to toggle source

Used to pass all concat references to the template. This ensures proper binding. Concat adds a String to the template Output buffer. Useful when trying to add a String with no block.

@params [String] text

# File lib/bootstrap3_helper/component.rb, line 51
def concat(text)
  @template.concat(text)
end
content_tag( name, content_or_options_with_block = nil, options = nil, escape = true, &block ) click to toggle source

Used to pass all context of content_tag to the template. This ensures proper template binding of variables and methods!

@return [String]

# File lib/bootstrap3_helper/component.rb, line 29
def content_tag(
  name,
  content_or_options_with_block = nil,
  options = nil,
  escape = true,
  &block
)
  @template.content_tag(
    name,
    content_or_options_with_block,
    options,
    escape,
    &block
  )
end
parse_arguments(*args) click to toggle source

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.

@params [Hash|NilClass|String|Symbol] *args @return [Array]

# File lib/bootstrap3_helper/component.rb, line 63
def parse_arguments(*args)
  first, second = *args
  case first
  when Hash, NilClass
    ['default', first || second]
  when Symbol, String
    [first, second]
  end
end
uuid() click to toggle source

Used to generate a (hopefully) unique ID for DOM elements. Used as a fallback if the user doesn't specify one.

@return [String]

# File lib/bootstrap3_helper/component.rb, line 78
def uuid
  (0...10).map { rand(65..90).chr }.join
end