Class: Bootstrap4Helper::Component

Inherits:
Object
  • Object
show all
Defined in:
lib/bootstrap4_helper/component.rb

Overview

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.

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

Instance Method Summary collapse

Constructor Details

#initialize(template) ⇒ Component

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

Parameters:

  • template (Class) 


20
21
22
 
# File 'lib/bootstrap4_helper/component.rb', line 20

def initialize(template)
  @template = template
end

Instance Method Details

#capture(*args) ⇒ String

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

Parameters:

  • args (Mixed)

Returns:

  • (String) 


55
56
57
 
# File 'lib/bootstrap4_helper/component.rb', line 55

def capture(*args)
  @template.capture(*args)
end

#concat(text) ⇒ String

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.

Parameters:

  • text (String)

Returns:

  • (String) 


66
67
68
 
# File 'lib/bootstrap4_helper/component.rb', line 66

def concat(text)
  @template.concat(text)
end

#config(setting, fallback) ⇒ Mixed

Used to get config settings inside of components quicker.

Parameters:

  • setting (Symbol)

Returns:

  • (Mixed) 


102
103
104
 
# File 'lib/bootstrap4_helper/component.rb', line 102

def config(setting, fallback)
  Bootstrap4Helper.config.send(setting) || fallback
end

#content_tag(name, content_or_options_with_block = nil, options = nil, escape = true, &block) ⇒ String

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

Parameters:

  • name (String)
  • content_or_options_with_block (Hash|NilClass) (defaults to: nil)
  • options (Hash|NilClass) (defaults to: nil)
  • escape (Boolean) (defaults to: true)

Returns:

  • (String) 


33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
 
# File 'lib/bootstrap4_helper/component.rb', line 33

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) ⇒ Array

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 ‘secondary` and return the Hash to be used as options.

Parameters:

  • args (Hash|NilClass|String|Symbol)

Returns:

  • (Array) 


78
79
80
81
82
83
84
85
86
 
# File 'lib/bootstrap4_helper/component.rb', line 78

def parse_arguments(*args)
  first, second = *args
  case first
  when Hash, NilClass
    ['secondary', first || second]
  when Symbol, String
    [first, second]
  end
end

#uuid ⇒ String

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

Returns:

  • (String) 


93
94
95
 
# File 'lib/bootstrap4_helper/component.rb', line 93

def uuid
  (0...10).map { rand(65..90).chr }.join
end