A SassScript parse node representing a function call.
A function call either calls one of the functions in {Script::Functions}, or if no function with the given name exists it returns a string representation of the function call.
@param name [String] See {#name} @param args [Array<Script::Node>] See {#args} @param keywords [{String => Script::Node}] See {#keywords}
# File lib/sass/script/funcall.rb, line 29 def initialize(name, args, keywords) @name = name @args = args @keywords = keywords super() end
Returns the arguments to the function.
@return [Array<Node>] @see Node#children
# File lib/sass/script/funcall.rb, line 56 def children @args + @keywords.values end
@see Node#deep_copy
# File lib/sass/script/funcall.rb, line 61 def deep_copy node = dup node.instance_variable_set('@args', args.map {|a| a.deep_copy}) node.instance_variable_set('@keywords', Hash[keywords.map {|k, v| [k, v.deep_copy]}]) node end
@return [String] A string representation of the function call
# File lib/sass/script/funcall.rb, line 37 def inspect args = @args.map {|a| a.inspect}.join(', ') keywords = Sass::Util.hash_to_a(@keywords). map {|k, v| "$#{k}: #{v.inspect}"}.join(', ') "#{name}(#{args}#{', ' unless args.empty? || keywords.empty?}#{keywords})" end
@see Node#to_sass
# File lib/sass/script/funcall.rb, line 45 def to_sass(opts = {}) args = @args.map {|a| a.to_sass(opts)}.join(', ') keywords = Sass::Util.hash_to_a(@keywords). map {|k, v| "$#{dasherize(k, opts)}: #{v.to_sass(opts)}"}.join(', ') "#{dasherize(name, opts)}(#{args}#{', ' unless args.empty? || keywords.empty?}#{keywords})" end
Evaluates the function call.
@param environment [Sass::Environment] The environment in which to evaluate the SassScript @return [Literal] The SassScript object that is the value of the function call @raise [Sass::SyntaxError] if the function call raises an ArgumentError
# File lib/sass/script/funcall.rb, line 75 def _perform(environment) args = @args.map {|a| a.perform(environment)} if fn = environment.function(@name) keywords = Sass::Util.map_hash(@keywords) {|k, v| [k, v.perform(environment)]} return perform_sass_fn(fn, args, keywords) end ruby_name = @name.tr('-', '_') args = construct_ruby_args(ruby_name, args, environment) unless Functions.callable?(ruby_name) opts(to_literal(args)) else opts(Functions::EvaluationContext.new(environment.options).send(ruby_name, *args)) end rescue ArgumentError => e # If this is a legitimate Ruby-raised argument error, re-raise it. # Otherwise, it's an error in the user's stylesheet, so wrap it. if e.message =~ /^wrong number of arguments \(\d+ for \d+\)/ && e.backtrace[0] !~ /:in `(block in )?#{ruby_name}'$/ raise e end raise Sass::SyntaxError.new("#{e.message} for `#{name}'") end
This method is factored out from `_perform` so that compass can override it with a cross-browser implementation for functions that require vendor prefixes in the generated css.
# File lib/sass/script/funcall.rb, line 103 def to_literal(args) Script::String.new("#{name}(#{args.join(', ')})") end
Generated with the Darkfish Rdoc Generator 2.