class Sass::Script::Node - sass-3.2.19 Documentation

# class Sass::Script::Node

The abstract superclass for SassScript parse tree nodes.

Use {#perform} to evaluate a parse tree.

### Attributes

line[RW]

The line of the document on which this node appeared.

@return [Fixnum]

options[R]

The options hash for this node.

@return [{Symbol => Object}]

### Public Instance Methods

children() click to toggle source

Returns all child nodes of this node.

@return [Array<Node>]

    # File lib/sass/script/node.rb, line 49
    def children
      Sass::Util.abstract(self)
    end

deep_copy() click to toggle source

Returns a deep clone of this node. The child nodes are cloned, but options are not.

@return [Node]

    # File lib/sass/script/node.rb, line 64
    def deep_copy
      Sass::Util.abstract(self)
    end

options=(options) click to toggle source

Sets the options hash for this node, as well as for all child nodes. See {file:SASS_REFERENCE.md#sass_options the Sass options documentation}.

@param options [{Symbol => Object}] The options

    # File lib/sass/script/node.rb, line 21
    def options=(options)
      @options = options
      children.each do |c|
        if c.is_a? Hash
          c.values.each {|v| v.options = options }
        else
          c.options = options
        end
      end
    end

perform(environment) click to toggle source

Evaluates the node.

{#perform} shouldn't be overridden directly; instead, override {#_perform}.

@param environment [Sass::Environment] The environment in which to evaluate the SassScript @return [Literal] The SassScript object that is the value of the SassScript

    # File lib/sass/script/node.rb, line 39
    def perform(environment)
      _perform(environment)
    rescue Sass::SyntaxError => e
      e.modify_backtrace(:line => line)
      raise e
    end

to_sass(opts = {}) click to toggle source

Returns the text of this SassScript expression.

@return [String]

    # File lib/sass/script/node.rb, line 56
    def to_sass(opts = {})
      Sass::Util.abstract(self)
    end

### Protected Instance Methods

_perform(environment) click to toggle source

Evaluates this node. Note that all {Literal} objects created within this method should have their {#options} attribute set, probably via {#opts}.

@param environment [Sass::Environment] The environment in which to evaluate the SassScript @return [Literal] The SassScript object that is the value of the SassScript @see perform

    # File lib/sass/script/node.rb, line 86
    def _perform(environment)
      Sass::Util.abstract(self)
    end

dasherize(s, opts) click to toggle source

Converts underscores to dashes if the :dasherize option is set.

    # File lib/sass/script/node.rb, line 71
    def dasherize(s, opts)
      if opts[:dasherize]
        s.gsub(/_/,'-')
      else
        s
      end
    end

opts(literal) click to toggle source

Sets the {#options} field on the given literal and returns it

@param literal [Literal] @return [Literal]

    # File lib/sass/script/node.rb, line 94
    def opts(literal)
      literal.options = options
      literal
    end