Class: Sass::Tree::Node

Inherits:

Object

• Object
• Sass::Tree::Node

show all

Includes:

Enumerable

Defined in:

.ruby-sass/lib/sass/tree/node.rb

Overview

Instance Attribute Summary (collapse)

• #children ⇒ Array<Tree::Node>

  The child nodes of this node.

• #filename ⇒ String

  The name of the document on which this node appeared.

• #has_children ⇒ Boolean

  Whether or not this node has child nodes.

• #line ⇒ Integer

  The line of the document on which this node appeared.

• #options ⇒ {Symbol => Object}

  The options hash for the node.

• #source_range ⇒ Sass::Source::Range

  The source range in the document on which this node appeared.

Class Method Summary (collapse)

• .inherited(base) ⇒ Object

Instance Method Summary (collapse)

• #<<(child) ⇒ Object

  Appends a child to the node.

• #==(other) ⇒ Boolean

  Compares this node and another object (only other Nodes will be equal).

• #bubbles? ⇒ Boolean

  Whether or not this node bubbles up through RuleNodes.

• #css ⇒ String

  Computes the CSS corresponding to this static CSS tree.

• #css_with_sourcemap ⇒ (String, Sass::Source::Map)

  Computes the CSS corresponding to this static CSS tree, along with the respective source map.

• #deep_copy ⇒ Node

  Return a deep clone of this node.

• #each {|node| ... } ⇒ Object

  Iterates through each node in the tree rooted at this node in a pre-order walk.

• #initialize ⇒ Node constructor

  A new instance of Node.

• #inspect ⇒ String

  Returns a representation of the node for debugging purposes.

• #invisible? ⇒ Boolean

  True if #to_s will return `nil`; that is, if the node shouldn't be rendered.

• #style ⇒ Symbol

  The output style.

• #to_sass(options = {}) ⇒ String

  Converts a node to Sass code that will generate it.

• #to_scss(options = {}) ⇒ String

  Converts a node to SCSS code that will generate it.

91
92
93
94
95

# File '.ruby-sass/lib/sass/tree/node.rb', line 91

def initialize
  @children = []
  @filename = nil
  @options = nil
end

91
92
93
94
95

# File '.ruby-sass/lib/sass/tree/node.rb', line 91

def initialize
  @children = []
  @filename = nil
  @options = nil
end

61
62
63

# File '.ruby-sass/lib/sass/tree/node.rb', line 61

def children
  @children
end

114
115
116

# File '.ruby-sass/lib/sass/tree/node.rb', line 114

def filename
  @filename || (@options && @options[:filename])
end

68
69
70

# File '.ruby-sass/lib/sass/tree/node.rb', line 68

def has_children
  @has_children
end

73
74
75

# File '.ruby-sass/lib/sass/tree/node.rb', line 73

def line
  @line
end

89
90
91

# File '.ruby-sass/lib/sass/tree/node.rb', line 89

def options
  @options
end

78
79
80

# File '.ruby-sass/lib/sass/tree/node.rb', line 78

def source_range
  @source_range
end

33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56

# File '.ruby-sass/lib/sass/tree/node.rb', line 33

def self.inherited(base)
  node_name = base.name.gsub(/.*::(.*?)Node$/, '\\1').downcase
  base.instance_eval <<-METHODS
    # @return [Symbol] The name that is used for this node when visiting.
    def node_name
      :#{node_name}
    end

    # @return [Symbol] The method that is used on the visitor to visit nodes of this type.
    def visit_method
      :visit_#{node_name}
    end

    # @return [Symbol] The method name that determines if the parent is invalid.
    def invalid_child_method_name
      :"invalid_#{node_name}_child?"
    end

    # @return [Symbol] The method name that determines if the node is an invalid parent.
    def invalid_parent_method_name
      :"invalid_#{node_name}_parent?"
    end
  METHODS
end

122
123
124
125
126
127
128
129
130

# File '.ruby-sass/lib/sass/tree/node.rb', line 122

def <<(child)
  return if child.nil?
  if child.is_a?(Array)
    child.each {|c| self << c}
  else
    self.has_children = true
    @children << child
  end
end

143
144
145

# File '.ruby-sass/lib/sass/tree/node.rb', line 143

def ==(other)
  self.class == other.class && other.children == children
end

225
226
227

# File '.ruby-sass/lib/sass/tree/node.rb', line 225

def bubbles?
  false
end

165
166
167

# File '.ruby-sass/lib/sass/tree/node.rb', line 165

def css
  Sass::Tree::Visitors::ToCss.new.visit(self)
end

174
175
176
177
178

# File '.ruby-sass/lib/sass/tree/node.rb', line 174

def css_with_sourcemap
  visitor = Sass::Tree::Visitors::ToCss.new(:build_source_mapping)
  result = visitor.visit(self)
  return result, visitor.source_mapping
end

218
219
220

# File '.ruby-sass/lib/sass/tree/node.rb', line 218

def deep_copy
  Sass::Tree::Visitors::DeepCopy.visit(self)
end

193
194
195
196

# File '.ruby-sass/lib/sass/tree/node.rb', line 193

def each
  yield self
  children.each {|c| c.each {|n| yield n}}
end

183
184
185
186

# File '.ruby-sass/lib/sass/tree/node.rb', line 183

def inspect
  return self.class.to_s unless has_children
  "(#{self.class} #{children.map {|c| c.inspect}.join(' ')})"
end

152

# File '.ruby-sass/lib/sass/tree/node.rb', line 152

def invisible?; false; end

157
158
159

# File '.ruby-sass/lib/sass/tree/node.rb', line 157

def style
  @options[:style]
end

202
203
204

# File '.ruby-sass/lib/sass/tree/node.rb', line 202

def to_sass(options = {})
  Sass::Tree::Visitors::Convert.visit(self, options, :sass)
end

210
211
212

# File '.ruby-sass/lib/sass/tree/node.rb', line 210

def to_scss(options = {})
  Sass::Tree::Visitors::Convert.visit(self, options, :scss)
end