Module: Glimmer::Web::Component::ClassMethods

Includes:
Glimmer
Defined in:
lib/glimmer/web/component.rb

Instance Method Summary collapse

Instance Method Details

#after_render(&block) ⇒ Object 



88
89
90
 
# File 'lib/glimmer/web/component.rb', line 88

def after_render(&block)
  @after_render = block
end

#before_render(&block) ⇒ Object 



75
76
77
 
# File 'lib/glimmer/web/component.rb', line 75

def before_render(&block)
  @before_render = block
end

#component_element_class ⇒ Object 



101
102
103
 
# File 'lib/glimmer/web/component.rb', line 101

def component_element_class
  self.keyword.gsub('_', '-')
end

#component_shortcut_element_class ⇒ Object 



105
106
107
 
# File 'lib/glimmer/web/component.rb', line 105

def component_shortcut_element_class
  self.shortcut_keyword.gsub('_', '-')
end

#create(*args) ⇒ Object

Creates component without rendering



110
111
112
113
114
115
 
# File 'lib/glimmer/web/component.rb', line 110

def create(*args)
  args << {} unless args.last.is_a?(Hash)
  args.last[:render] = false
  rendered_component = send(keyword, *args)
  rendered_component
end

#def_option_attr_accessors(new_options) ⇒ Object 



64
65
66
67
68
69
70
71
72
73
 
# File 'lib/glimmer/web/component.rb', line 64

def def_option_attr_accessors(new_options)
  new_options.each do |option, default|
    define_method(option) do
      options[:"#{option}"]
    end
    define_method("#{option}=") do |option_value|
      self.options[:"#{option}"] = option_value
    end
  end
end

#keyword ⇒ Object 



92
93
94
 
# File 'lib/glimmer/web/component.rb', line 92

def keyword
  self.name.underscore.gsub('::', '__')
end

#markup(&block) ⇒ Object 



79
80
81
 
# File 'lib/glimmer/web/component.rb', line 79

def markup(&block)
  @markup_block = block
end

#option(new_option, default: nil) ⇒ Object Also known as: attribute 



54
55
56
57
58
59
60
61
 
# File 'lib/glimmer/web/component.rb', line 54

def option(new_option, default: nil)
  new_option = new_option.to_s.to_sym
  new_options = {new_option => default}
  '@options = options.merge(new_options)'
  @options = options.merge(new_options)
  'def_option_attr_accessors(new_options)'
  def_option_attr_accessors(new_options)
end

#options(*new_options) ⇒ Object Also known as: attributes

Allows defining convenience option accessors for an array of option names Example: ‘options :color1, :color2` defines `#color1` and `#color2` where they return the instance values `options` and `options` respectively. Can be called multiple times to set more options additively. When passed no arguments, it returns list of all option names captured so far



42
43
44
45
46
47
48
49
50
51
 
# File 'lib/glimmer/web/component.rb', line 42

def options(*new_options)
  new_options = new_options.compact.map(&:to_s).map(&:to_sym)
  if new_options.empty?
    @options ||= {} # maps options to defaults
  else
    new_options = new_options.reduce({}) {|new_options_hash, new_option| new_options_hash.merge(new_option => nil)}
    @options = options.merge(new_options)
    def_option_attr_accessors(new_options)
  end
end

#render(*args) ⇒ Object

Creates and renders component



118
119
120
121
122
 
# File 'lib/glimmer/web/component.rb', line 118

def render(*args)
  Glimmer::DSL::Engine.new_parent_stack unless Glimmer::DSL::Engine.parent.nil?
  rendered_component = send(keyword, *args)
  rendered_component
end

#shortcut_keyword ⇒ Object

Returns shortcut keyword to use for this component (keyword minus namespace)



97
98
99
 
# File 'lib/glimmer/web/component.rb', line 97

def shortcut_keyword
  self.name.underscore.gsub('::', '__').split('__').last
end

#style(&block) ⇒ Object

TODO in the future support a string value too



84
85
86
 
# File 'lib/glimmer/web/component.rb', line 84

def style(&block)
  @style_block = block
end