Class: Less::Node::Element
- 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
Direct Known Subclasses
Instance Attribute Summary collapse
-
#file ⇒ Object
Returns the value of attribute file.
-
#imported ⇒ Object
Returns the value of attribute imported.
-
#name ⇒ Object
Returns the value of attribute name.
-
#rules ⇒ Object
Returns the value of attribute rules.
-
#selector ⇒ Object
Returns the value of attribute selector.
-
#set ⇒ Object
Returns the value of attribute set.
Attributes included from Entity
Instance Method Summary collapse
-
#<<(obj) ⇒ Object
Add an arbitrary node to this element.
- #==(other) ⇒ Object
-
#[](key) ⇒ Object
Select a child element TODO: Implement full selector syntax & merge with descend().
- #class? ⇒ Boolean
-
#descend(selector, element) ⇒ Object
Same as above, except with a specific selector TODO: clean this up or implement it differently.
-
#each(path = [], &blk) ⇒ Object
Traverse the whole tree, returning each leaf (recursive).
- #elements ⇒ Object
- #empty? ⇒ Boolean
- #eql?(other) ⇒ Boolean
- #equiv?(other) ⇒ Boolean
- #first ⇒ Object
-
#group ⇒ Object
Group similar rulesets together This is horrible, horrible code, but it’ll have to do until I find a proper way to do it.
- #id? ⇒ Boolean
-
#identifiers ⇒ Object
Accessors for the different nodes in @rules.
-
#initialize(name = "", selector = '') ⇒ Element
constructor
A new instance of Element.
- #inspect(depth = 0) ⇒ Object
- #last ⇒ Object
- #leaf? ⇒ Boolean
- #mix(arr = []) ⇒ Object
- #mixins ⇒ Object
-
#nearest(ident, type = nil) ⇒ Object
Find the nearest node in the hierarchy or raise a NameError.
- #parameters ⇒ Object
- #properties ⇒ Object
-
#root? ⇒ Boolean
Top-most node?.
- #tag? ⇒ Boolean
-
#to_css(path = []) ⇒ Object
Entry point for the css conversion.
- #to_s ⇒ Object
- #universal? ⇒ Boolean
- #variables ⇒ Object
Methods included from Entity
Constructor Details
#initialize(name = "", selector = '') ⇒ Element
Returns a new instance of Element.
18 19 20 21 22 23 |
# File 'lib/less/engine/nodes/element.rb', line 18 def initialize name = "", selector = '' @name = name @set, @imported = [], [] @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 |
#imported ⇒ Object
Returns the value of attribute imported.
15 16 17 |
# File 'lib/less/engine/nodes/element.rb', line 15 def imported @imported end |
#name ⇒ Object
Returns the value of attribute name.
15 16 17 |
# File 'lib/less/engine/nodes/element.rb', line 15 def name @name 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 |
#set ⇒ Object
Returns the value of attribute set.
15 16 17 |
# File 'lib/less/engine/nodes/element.rb', line 15 def set @set end |
Instance Method Details
#<<(obj) ⇒ Object
Add an arbitrary node to this element
132 133 134 135 136 137 138 139 |
# File 'lib/less/engine/nodes/element.rb', line 132 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 |
#==(other) ⇒ Object
95 96 97 |
# File 'lib/less/engine/nodes/element.rb', line 95 def == other name == other.name end |
#[](key) ⇒ Object
Select a child element TODO: Implement full selector syntax & merge with descend()
85 86 87 88 89 90 91 92 93 |
# File 'lib/less/engine/nodes/element.rb', line 85 def [] key case key when Entity @rules.find {|i| i.eql? key } when String @rules.find {|i| i.to_s == key } else raise ArgumentError end end |
#class? ⇒ Boolean
25 |
# File 'lib/less/engine/nodes/element.rb', line 25 def class?; name =~ /^\./ end |
#descend(selector, element) ⇒ Object
Same as above, except with a specific selector TODO: clean this up or implement it differently
112 113 114 115 116 117 118 119 120 121 |
# File 'lib/less/engine/nodes/element.rb', line 112 def descend selector, element if selector.is_a? Child s = self[element.name].selector self[element.name] if s.is_a? Child or s.is_a? Descendant elsif selector.is_a? Descendant self[element.name] else self[element.name] if self[element.name].selector.class == selector.class end end |
#each(path = [], &blk) ⇒ Object
Traverse the whole tree, returning each leaf (recursive)
183 184 185 186 187 188 189 190 191 |
# File 'lib/less/engine/nodes/element.rb', line 183 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
79 |
# File 'lib/less/engine/nodes/element.rb', line 79 def elements; @rules.select {|r| r.kind_of? Element } end |
#empty? ⇒ Boolean
38 39 40 |
# File 'lib/less/engine/nodes/element.rb', line 38 def empty? @rules.empty? end |
#eql?(other) ⇒ Boolean
99 100 101 |
# File 'lib/less/engine/nodes/element.rb', line 99 def eql? other super and self.equiv? other end |
#equiv?(other) ⇒ Boolean
103 104 105 106 107 108 |
# File 'lib/less/engine/nodes/element.rb', line 103 def equiv? other rules.size == other.rules.size and !rules.zip(other.rules).map do |a, b| a.to_css == b.to_css end.include?(false) end |
#first ⇒ Object
142 |
# File 'lib/less/engine/nodes/element.rb', line 142 def first; elements.first end |
#group ⇒ Object
Group similar rulesets together This is horrible, horrible code, but it’ll have to do until I find a proper way to do it.
50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 |
# File 'lib/less/engine/nodes/element.rb', line 50 def group matched = false stack, result = elements.dup, [] return self unless elements.size > 1 elements.each do e = stack.first result << e unless matched matched = stack[1..-1].each do |ee| if e.equiv? ee and e.elements.size == 0 self[e].set << ee stack.shift else stack.shift break false end end if stack.size > 1 end @rules -= (elements - result) self end |
#id? ⇒ Boolean
26 |
# File 'lib/less/engine/nodes/element.rb', line 26 def id?; name =~ /^#/ end |
#identifiers ⇒ Object
Accessors for the different nodes in @rules
76 |
# File 'lib/less/engine/nodes/element.rb', line 76 def identifiers; @rules.select {|r| r.kind_of? Property } end |
#inspect(depth = 0) ⇒ Object
193 194 195 196 197 198 199 200 201 202 203 |
# File 'lib/less/engine/nodes/element.rb', line 193 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.to_s, put[ variables ], put[ properties ], elements.map {|i| i.inspect( depth + 1 ) } * "\n" ].reject(&:empty?).join("\n") + "\n" + indent[ depth ] end |
#last ⇒ Object
141 |
# File 'lib/less/engine/nodes/element.rb', line 141 def last; elements.last end |
#leaf? ⇒ Boolean
42 43 44 |
# File 'lib/less/engine/nodes/element.rb', line 42 def leaf? elements.empty? end |
#mix(arr = []) ⇒ Object
123 124 125 126 127 |
# File 'lib/less/engine/nodes/element.rb', line 123 def mix arr = [] @rules += arr.map do |r| r.copy.tap {|i| i.parent = self } end end |
#mixins ⇒ Object
80 |
# File 'lib/less/engine/nodes/element.rb', line 80 def mixins; @rules.select {|r| r.instance_of? Mixin } end |
#nearest(ident, type = nil) ⇒ Object
Find the nearest node in the hierarchy or raise a NameError
171 172 173 174 175 176 177 178 |
# File 'lib/less/engine/nodes/element.rb', line 171 def nearest ident, type = nil ary = type || 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 |
#parameters ⇒ Object
81 |
# File 'lib/less/engine/nodes/element.rb', line 81 def parameters; [] end |
#properties ⇒ Object
77 |
# File 'lib/less/engine/nodes/element.rb', line 77 def properties; @rules.select {|r| r.instance_of? Property } end |
#root? ⇒ Boolean
Top-most node?
34 35 36 |
# File 'lib/less/engine/nodes/element.rb', line 34 def root? parent.nil? end |
#tag? ⇒ 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
148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 |
# File 'lib/less/engine/nodes/element.rb', line 148 def to_css path = [] path << @selector.to_css << name 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, *@set.map(&:name)].uniq * ', '} {#{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
143 |
# File 'lib/less/engine/nodes/element.rb', line 143 def to_s; root?? '*' : name end |
#universal? ⇒ Boolean
27 |
# File 'lib/less/engine/nodes/element.rb', line 27 def universal?; name == '*' end |