class Sass::Script::Tree::ListLiteral

A parse tree node representing a list literal. When resolved, this returns a {Sass::Tree::Value::List}.

Attributes

bracketed[R]

Whether the list is surrounded by square brackets.

@return [Boolean]

elements[R]

The parse nodes for members of this list.

@return [Array<Node>]

separator[R]

The operator separating the values of the list. Either ‘:comma` or `:space`.

@return [Symbol]

Public Class Methods

new(elements, separator: nil, bracketed: false) click to toggle source

Creates a new list literal.

@param elements [Array<Node>] See {#elements} @param separator [Symbol] See {#separator} @param bracketed [Boolean] See {#bracketed}

# File lib/sass/script/tree/list_literal.rb, line 26
def initialize(elements, separator: nil, bracketed: false)
  @elements = elements
  @separator = separator
  @bracketed = bracketed
end

Public Instance Methods

children() click to toggle source

@see Node#children

# File lib/sass/script/tree/list_literal.rb, line 33
def children; elements; end
deep_copy() click to toggle source

@see Node#deep_copy

# File lib/sass/script/tree/list_literal.rb, line 55
def deep_copy
  node = dup
  node.instance_variable_set('@elements', elements.map {|e| e.deep_copy})
  node
end
force_division!() click to toggle source
# File lib/sass/script/tree/list_literal.rb, line 67
def force_division!
  # Do nothing. Lists prevent division propagation.
end
inspect() click to toggle source
# File lib/sass/script/tree/list_literal.rb, line 61
def inspect
  (bracketed ? '[' : '(') +
    elements.map {|e| e.inspect}.join(separator == :space ? ' ' : ', ') +
    (bracketed ? ']' : ')')
end
to_sass(opts = {}) click to toggle source

@see Value#to_sass

# File lib/sass/script/tree/list_literal.rb, line 36
def to_sass(opts = {})
  return bracketed ? "[]" : "()" if elements.empty?
  members = elements.map do |v|
    if element_needs_parens?(v)
      "(#{v.to_sass(opts)})"
    else
      v.to_sass(opts)
    end
  end

  if separator == :comma && members.length == 1
    return "#{bracketed ? '[' : '('}#{members.first},#{bracketed ? ']' : ')'}"
  end

  contents = members.join(sep_str(nil))
  bracketed ? "[#{contents}]" : contents
end

Protected Instance Methods

_perform(environment) click to toggle source
# File lib/sass/script/tree/list_literal.rb, line 73
def _perform(environment)
  list = Sass::Script::Value::List.new(
    elements.map {|e| e.perform(environment)},
    separator: separator,
    bracketed: bracketed)
  list.source_range = source_range
  list.options = options
  list
end

Private Instance Methods

element_needs_parens?(element) click to toggle source

Returns whether an element in the list should be wrapped in parentheses when serialized to Sass.

# File lib/sass/script/tree/list_literal.rb, line 87
def element_needs_parens?(element)
  if element.is_a?(ListLiteral)
    return false if element.elements.length < 2
    return false if element.bracketed
    return Sass::Script::Parser.precedence_of(element.separator || :space) <=
           Sass::Script::Parser.precedence_of(separator || :space)
  end

  return false unless separator == :space

  if element.is_a?(UnaryOperation)
    return element.operator == :minus || element.operator == :plus
  end

  return false unless element.is_a?(Operation)
  return true unless element.operator == :div
  !(is_literal_number?(element.operand1) && is_literal_number?(element.operand2))
end
is_literal_number?(value) click to toggle source

Returns whether a value is a number literal that shouldn’t be divided.

# File lib/sass/script/tree/list_literal.rb, line 107
def is_literal_number?(value)
  value.is_a?(Literal) &&
    value.value.is_a?((Sass::Script::Value::Number)) &&
    !value.value.original.nil?
end
sep_str(opts = options) click to toggle source
# File lib/sass/script/tree/list_literal.rb, line 113
def sep_str(opts = options)
  return ' ' if separator == :space
  return ',' if opts && opts[:style] == :compressed
  ', '
end