Class: Less::Node::Element

Inherits:
String show all
Includes:
Enumerable, Entity
Defined in:
lib/less/engine/nodes/element.rb

Overview

Element

div …

TODO: Look into making @rules its own hash-like class TODO: Look into whether selector should be child by default

Instance Attribute Summary collapse

Attributes included from Entity

#parent

Instance Method Summary collapse

Methods included from Entity

#path, #root

Methods inherited from String

#blank?, #column_of, #indent, #line_of, #tabto, #treetop_camelize

Constructor Details

#initialize(name = "", selector = '') ⇒ Element

Returns a new instance of Element.



17
18
19
20
21
22
23
 
# File 'lib/less/engine/nodes/element.rb', line 17

def initialize name = "", selector = ''
  super name

  @partial = false
  @rules = [] # Holds all the nodes under this element's hierarchy
  @selector = Selector[selector.strip].new  # descendant | child | adjacent
end

Instance Attribute Details

#file ⇒ Object

Returns the value of attribute file.



15
16
17
 
# File 'lib/less/engine/nodes/element.rb', line 15

def file
  @file
end

#partial ⇒ Object

Returns the value of attribute partial.



15
16
17
 
# File 'lib/less/engine/nodes/element.rb', line 15

def partial
  @partial
end

#rules ⇒ Object

Returns the value of attribute rules.



15
16
17
 
# File 'lib/less/engine/nodes/element.rb', line 15

def rules
  @rules
end

#selector ⇒ Object

Returns the value of attribute selector.



15
16
17
 
# File 'lib/less/engine/nodes/element.rb', line 15

def selector
  @selector
end

Instance Method Details

#<<(obj) ⇒ Object

Add an arbitrary node to this element



76
77
78
79
80
81
82
83
 
# File 'lib/less/engine/nodes/element.rb', line 76

def << obj
  if obj.kind_of? Node::Entity
    obj.parent = self
    @rules << obj
  else
    raise ArgumentError, "argument can't be a #{obj.class}"
  end
end

#[](key) ⇒ Object

Select a child element TODO: Implement full selector syntax & merge with descend()



56
57
58
 
# File 'lib/less/engine/nodes/element.rb', line 56

def [] key
  @rules.find {|i| i.to_s == key }
end

#class? ⇒ Boolean

Returns:

  • (Boolean) 


25
 
# File 'lib/less/engine/nodes/element.rb', line 25

def class?;     self =~ /^\./ end

#descend(selector, element) ⇒ Object

Same as above, except with a specific selector TODO: clean this up or implement it differently



62
63
64
65
66
67
68
69
70
71
 
# File 'lib/less/engine/nodes/element.rb', line 62

def descend selector, element
  if selector.is_a? Child
    s = self[element].selector
    self[element] if s.is_a? Child or s.is_a? Descendant
  elsif selector.is_a? Descendant
    self[element]
  else
    self[element] if self[element].selector.class == selector.class
  end
end

#each(path = [], &blk) ⇒ Object Also known as: traverse

Traverse the whole tree, returning each leaf (recursive)



126
127
128
129
130
131
132
133
134
 
# File 'lib/less/engine/nodes/element.rb', line 126

def each path = [], &blk
  elements.each do |element|                            
    path << element                         
    yield element, path if element.leaf?                
    element.each path, &blk                                        
    path.pop                    
  end
  self
end

#elements ⇒ Object 



52
 
# File 'lib/less/engine/nodes/element.rb', line 52

def elements;    @rules.select {|r| r.instance_of? Element  } end

#empty? ⇒ Boolean

Returns:

  • (Boolean) 


38
39
40
 
# File 'lib/less/engine/nodes/element.rb', line 38

def empty?
  @rules.empty?
end

#first ⇒ Object 



86
 
# File 'lib/less/engine/nodes/element.rb', line 86

def first; elements.first end

#id? ⇒ Boolean

Returns:

  • (Boolean) 


26
 
# File 'lib/less/engine/nodes/element.rb', line 26

def id?;        self =~ /^#/  end

#identifiers ⇒ Object

Accessors for the different nodes in @rules



49
 
# File 'lib/less/engine/nodes/element.rb', line 49

def identifiers; @rules.select {|r| r.kind_of?     Property } end

#inspect(depth = 0) ⇒ Object 



137
138
139
140
141
142
143
144
145
146
147
 
# File 'lib/less/engine/nodes/element.rb', line 137

def inspect depth = 0
  indent = lambda {|i| '.  ' * i }
  put    = lambda {|ary| ary.map {|i| indent[ depth + 1 ] + i.inspect } * "\n"}

  (root?? "\n" : "") + [
    indent[ depth ] + (self == '' ? '*' : self.to_s),
    put[ properties ],
    put[ variables ],
    elements.map {|i| i.inspect( depth + 1 ) } * "\n"
  ].reject(&:empty?).join("\n") + "\n" + indent[ depth ]
end

#last ⇒ Object 



85
 
# File 'lib/less/engine/nodes/element.rb', line 85

def last;  elements.last  end

#leaf? ⇒ Boolean

Returns:

  • (Boolean) 


42
43
44
 
# File 'lib/less/engine/nodes/element.rb', line 42

def leaf?
  elements.empty?
end

#nearest(ident) ⇒ Object

Find the nearest variable in the hierarchy or raise a NameError



114
115
116
117
118
119
120
121
 
# File 'lib/less/engine/nodes/element.rb', line 114

def nearest ident
  ary = ident =~ /^[.#]/ ? :elements : :variables
  path.map do |node|
    node.send(ary).find {|i| i.to_s == ident }
  end.compact.first.tap do |result|
    raise VariableNameError, ident unless result
  end
end

#properties ⇒ Object 



50
 
# File 'lib/less/engine/nodes/element.rb', line 50

def properties;  @rules.select {|r| r.instance_of? Property } end

#root? ⇒ Boolean

Top-most node?

Returns:

  • (Boolean) 


34
35
36
 
# File 'lib/less/engine/nodes/element.rb', line 34

def root?
  self == '' && parent.nil?
end

#tag? ⇒ Boolean

Returns:

  • (Boolean) 


29
30
31
 
# File 'lib/less/engine/nodes/element.rb', line 29

def tag? 
  not id? || class? || universal?
end

#to_css(path = []) ⇒ Object

Entry point for the css conversion



92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
 
# File 'lib/less/engine/nodes/element.rb', line 92

def to_css path = []
  path << @selector.to_css << self unless root?

  content = properties.map do |i|
    ' ' * 2 + i.to_css
  end.compact.reject(&:empty?) * "\n"
    
  content = content.include?("\n") ? 
    "\n#{content}\n" : " #{content.strip} "
  ruleset = !content.strip.empty?? 
    "#{path.reject(&:empty?).join.strip} {#{content}}\n" : ""
    
  css = ruleset + elements.map do |i|
    i.to_css(path)
  end.reject(&:empty?).join
  path.pop; path.pop
  css
end

#to_s ⇒ Object 



87
 
# File 'lib/less/engine/nodes/element.rb', line 87

def to_s; super end

#universal? ⇒ Boolean

Returns:

  • (Boolean) 


27
 
# File 'lib/less/engine/nodes/element.rb', line 27

def universal?; self == '*'   end

#variables ⇒ Object 



51
 
# File 'lib/less/engine/nodes/element.rb', line 51

def variables;   @rules.select {|r| r.instance_of? Variable } end