| module Sass::Script::Tree |
| # A parse tree node representing a list literal. When resolved, this returns a |
| # {Sass::Tree::Value::List}. |
| class ListLiteral < Node |
| # The parse nodes for members of this list. |
| # |
| # @return [Array<Node>] |
| attr_reader :elements |
| |
| # The operator separating the values of the list. Either `:comma` or |
| # `:space`. |
| # |
| # @return [Symbol] |
| attr_reader :separator |
| |
| # Whether the list is surrounded by square brackets. |
| # |
| # @return [Boolean] |
| attr_reader :bracketed |
| |
| # Creates a new list literal. |
| # |
| # @param elements [Array<Node>] See \{#elements} |
| # @param separator [Symbol] See \{#separator} |
| # @param bracketed [Boolean] See \{#bracketed} |
| def initialize(elements, separator: nil, bracketed: false) |
| @elements = elements |
| @separator = separator |
| @bracketed = bracketed |
| end |
| |
| # @see Node#children |
| def children; elements; end |
| |
| # @see Value#to_sass |
| 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 |
| |
| # @see Node#deep_copy |
| def deep_copy |
| node = dup |
| node.instance_variable_set('@elements', elements.map {|e| e.deep_copy}) |
| node |
| end |
| |
| def inspect |
| (bracketed ? '[' : '(') + |
| elements.map {|e| e.inspect}.join(separator == :space ? ' ' : ', ') + |
| (bracketed ? ']' : ')') |
| end |
| |
| def force_division! |
| # Do nothing. Lists prevent division propagation. |
| end |
| |
| protected |
| |
| 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 |
| |
| # Returns whether an element in the list should be wrapped in parentheses |
| # when serialized to Sass. |
| 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 |
| |
| # Returns whether a value is a number literal that shouldn't be divided. |
| def is_literal_number?(value) |
| value.is_a?(Literal) && |
| value.value.is_a?((Sass::Script::Value::Number)) && |
| !value.value.original.nil? |
| end |
| |
| def sep_str(opts = options) |
| return ' ' if separator == :space |
| return ',' if opts && opts[:style] == :compressed |
| ', ' |
| end |
| end |
| end |