Class: Sass::Tree::MixinNode

Inherits:
Node
  • Object
show all
Defined in:
lib/sass/tree/mixin_node.rb

Overview

A static node representing a mixin include. When in a static tree, the sole purpose is to wrap exceptions to add the mixin to the backtrace.

See Also:

Constant Summary

Constants inherited from Node

Node::SAVED_OPTIONS

Instance Attribute Summary

Attributes inherited from Node

#children, #filename, #has_children, #line, #options

Instance Method Summary collapse

Methods inherited from Node

#<<, #==, #_around_dump, #_perform, #_to_s, #balance, #check_child!, #children_to_src, #cssize!, #dasherize, #do_extend, #each, #invisible?, #perform, #perform_children, #run_interp, #selector_to_sass, #selector_to_scss, #selector_to_src, #semi, #style, #to_s, #to_sass, #to_scss

Constructor Details

#initialize(name, args) ⇒ MixinNode

Returns a new instance of MixinNode.

Parameters:

  • name (String) —

    The name of the mixin

  • args (Array<Script::Node>) —

    The arguments to the mixin



18
19
20
21
22
 
# File 'lib/sass/tree/mixin_node.rb', line 18

def initialize(name, args)
  @name = name
  @args = args
  super()
end

Instance Method Details

#_cssize(extends, parent) (protected)

See Also:



50
51
52
53
54
55
56
57
58
59
 
# File 'lib/sass/tree/mixin_node.rb', line 50

def _cssize(extends, parent)
  children.map do |c|
    parent.check_child! c
    c.cssize(extends, parent)
  end.flatten
rescue Sass::SyntaxError => e
  e.modify_backtrace(:mixin => @name, :filename => filename, :line => line)
  e.add_backtrace(:filename => filename, :line => line)
  raise e
end

#cssize(extends, parent = nil)

See Also:



25
26
27
 
# File 'lib/sass/tree/mixin_node.rb', line 25

def cssize(extends, parent = nil)
  _cssize(extends, parent) # Pass on the parent even if it's not a MixinNode
end

#invalid_child?(child) ⇒ Boolean, String (protected)

Returns an error message if the given child node is invalid, and false otherwise.

ExtendNodes are valid within Sass::Tree::MixinNodes.

Parameters:

Returns:

  • (Boolean, String) —

    Whether or not the child node is valid, as well as the error message to display if it is invalid



39
40
41
 
# File 'lib/sass/tree/mixin_node.rb', line 39

def invalid_child?(child)
  super unless child.is_a?(ExtendNode)
end

#options=(opts)

See Also:



11
12
13
14
 
# File 'lib/sass/tree/mixin_node.rb', line 11

def options=(opts)
  super
  @args.each {|a| a.context = :equals} if opts[:sass2]
end

#perform!(environment) (protected)

Runs the mixin.

Parameters:

  • environment (Sass::Environment) —

    The lexical environment containing variable and mixin values

Raises:

See Also:



68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
 
# File 'lib/sass/tree/mixin_node.rb', line 68

def perform!(environment)
  handle_include_loop!(environment) if environment.mixins_in_use.include?(@name)

  original_env = environment
  original_env.push_frame(:filename => filename, :line => line)
  original_env.prepare_frame(:mixin => @name)
  raise Sass::SyntaxError.new("Undefined mixin '#{@name}'.") unless mixin = environment.mixin(@name)

  raise Sass::SyntaxError.new(<<END.gsub("\n", "")) if mixin.args.size < @args.size
Mixin #{@name} takes #{mixin.args.size} argument#{'s' if mixin.args.size != 1}
 but #{@args.size} #{@args.size == 1 ? 'was' : 'were'} passed.
END
  environment = mixin.args.zip(@args).
    inject(Sass::Environment.new(mixin.environment)) do |env, ((var, default), value)|
    env.set_local_var(var.name,
      if value
        value.perform(environment)
      elsif default
        val = default.perform(env)
        if default.context == :equals && val.is_a?(Sass::Script::String)
          val = Sass::Script::String.new(val.value)
        end
        val
      end)
    raise Sass::SyntaxError.new("Mixin #{@name} is missing parameter #{var.inspect}.") unless env.var(var.name)
    env
  end

  self.children = mixin.tree.map {|c| c.perform(environment)}.flatten
rescue Sass::SyntaxError => e
  if original_env # Don't add backtrace info if this is an @include loop
    e.modify_backtrace(:mixin => @name, :line => @line)
    e.add_backtrace(:line => @line)
  end
  raise e
ensure
  original_env.pop_frame if original_env
end

#to_src(tabs, opts, fmt) (protected)

See Also:



44
45
46
47
 
# File 'lib/sass/tree/mixin_node.rb', line 44

def to_src(tabs, opts, fmt)
  args = '(' + @args.map {|a| a.to_sass(opts)}.join(", ") + ')' unless @args.empty?
  "#{'  ' * tabs}#{fmt == :sass ? '+' : '@include '}#{dasherize(@name, opts)}#{args}#{semi fmt}\n"
end