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 Sass::Tree
| Class | Sass::Tree::MixinNode |
| In: |
lib/sass/tree/mixin_node.rb
|
| Parent: | Node |
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 Sass::Tree
@param name [String] The name of the mixin @param args [Array<Script::Node>] The arguments to the mixin
# File lib/sass/tree/mixin_node.rb, line 18
18: def initialize(name, args)
19: @name = name
20: @args = args
21: super()
22: end
@see Node#cssize
# File lib/sass/tree/mixin_node.rb, line 25
25: def cssize(extends, parent = nil)
26: _cssize(extends, parent) # Pass on the parent even if it's not a MixinNode
27: end
@see Node#options=
# File lib/sass/tree/mixin_node.rb, line 11
11: def options=(opts)
12: super
13: @args.each {|a| a.context = :equals} if opts[:sass2]
14: end
@see Node#_cssize
# File lib/sass/tree/mixin_node.rb, line 38
38: def _cssize(extends, parent)
39: children.map do |c|
40: parent.check_child! c
41: c.cssize(extends, parent)
42: end.flatten
43: rescue Sass::SyntaxError => e
44: e.modify_backtrace(:mixin => @name, :filename => filename, :line => line)
45: e.add_backtrace(:filename => filename, :line => line)
46: raise e
47: end
Runs the mixin.
@param environment [Sass::Environment] The lexical environment containing
variable and mixin values
@raise [Sass::SyntaxError] if there is no mixin with the given name @raise [Sass::SyntaxError] if an incorrect number of arguments was passed @see Sass::Tree
# File lib/sass/tree/mixin_node.rb, line 56
56: def perform!(environment)
57: handle_include_loop!(environment) if environment.mixins_in_use.include?(@name)
58:
59: original_env = environment
60: original_env.push_frame(:filename => filename, :line => line)
61: original_env.prepare_frame(:mixin => @name)
62: raise Sass::SyntaxError.new("Undefined mixin '#{@name}'.") unless mixin = environment.mixin(@name)
63:
64: raise Sass::SyntaxError.new("Mixin \#{@name} takes \#{mixin.args.size} argument\#{'s' if mixin.args.size != 1}\n but \#{@args.size} \#{@args.size == 1 ? 'was' : 'were'} passed.\n".gsub("\n", "")) if mixin.args.size < @args.size
65: environment = mixin.args.zip(@args).
66: inject(Sass::Environment.new(mixin.environment)) do |env, ((var, default), value)|
67: env.set_local_var(var.name,
68: if value
69: value.perform(environment)
70: elsif default
71: val = default.perform(env)
72: if default.context == :equals && val.is_a?(Sass::Script::String)
73: val = Sass::Script::String.new(val.value)
74: end
75: val
76: end)
77: raise Sass::SyntaxError.new("Mixin #{@name} is missing parameter #{var.inspect}.") unless env.var(var.name)
78: env
79: end
80:
81: self.children = mixin.tree.map {|c| c.perform(environment)}.flatten
82: rescue Sass::SyntaxError => e
83: if original_env # Don't add backtrace info if this is an @include loop
84: e.modify_backtrace(:mixin => @name, :line => @line)
85: e.add_backtrace(:line => @line)
86: end
87: raise e
88: ensure
89: original_env.pop_frame if original_env
90: end
@see Node#to_src
# File lib/sass/tree/mixin_node.rb, line 32
32: def to_src(tabs, opts, fmt)
33: args = '(' + @args.map {|a| a.to_sass(opts)}.join(", ") + ')' unless @args.empty?
34: "#{' ' * tabs}#{fmt == :sass ? '+' : '@include '}#{dasherize(@name, opts)}#{args}#{semi fmt}\n"
35: end
# File lib/sass/tree/mixin_node.rb, line 98
98: def handle_include_loop!(environment)
99: msg = "An @include loop has been found:"
100: mixins = environment.stack.map {|s| s[:mixin]}.compact
101: if mixins.size == 2 && mixins[0] == mixins[1]
102: raise Sass::SyntaxError.new("#{msg} #{@name} includes itself")
103: end
104:
105: mixins << @name
106: msg << "\n" << Haml::Util.enum_cons(mixins, 2).map do |m1, m2|
107: " #{m1} includes #{m2}"
108: end.join("\n")
109: raise Sass::SyntaxError.new(msg)
110: end