com.vaadin.sass.internal.parser
Interface SassListItem

All Known Implementing Classes:

ArgumentList, LexicalUnitImpl, SassExpression, SassList

public interface SassListItem

SassListItem specifies the interface implemented by both list items (LexicalUnitImpl) and lists (SassList). SassListItems are used as the elements of a SassList so that a list can contain both single values and other lists as its elements. To allow unified handling of lists and single values, SassListItem specifies several methods that are needed in both cases. This includes methods for replacing variables with their values and toString-like methods. Several list methods are also in the interface to allow a single value to behave like a list. For instance, it is possible to add an element to a single value and obtain a list as a result. The unified behavior of lists and single values is relevant because the value of a Sass variable can be either a list or a single value.

Method Summary

String	buildString(Node.BuildStringStrategy strategy) Return a string representation of this item using the given strategy of converting items to strings.
boolean	containsArithmeticalOperator() Checks whether the item contains an arithmetic expression.
SassListItem	evaluateFunctionsAndExpressions(boolean evaluateArithmetics) Evaluates the arithmetic expressions and functions of this item without modifying this item.
int	getColumnNumber()
LexicalUnitImpl	getContainedValue() Deprecated.
int	getLineNumber()
String	printState() Returns a string representation of this item.
SassListItem	replaceVariables(Collection<VariableNode> variable) Returns a new item that is otherwise equal to this one but all occurrences of the given variables have been replaced by the values given in the VariableNodes.
String	unquotedString() Returns a string representation of this item with surrounding quotation marks of the same type (" or ') removed.
void	updateUrl(String prefix) Updates all url's of this item by, e.g., adding the prefix to an url not starting with slash "/" and not containing the symbol ":".

Method Detail

getLineNumber

int getLineNumber()

getColumnNumber

int getColumnNumber()

containsArithmeticalOperator

boolean containsArithmeticalOperator()

Checks whether the item contains an arithmetic expression.

evaluateFunctionsAndExpressions

SassListItem evaluateFunctionsAndExpressions(boolean evaluateArithmetics)

Evaluates the arithmetic expressions and functions of this item without modifying this item.

Parameters:

evaluateArithmetics - True indicates that the arithmetic expressions in this item should be evaluated. This parameter is used to handle the case where the operator '/' should not be interpreted as an arithmetic operation. The arithmetic expressions occurring in the parameter lists of functions will be evaluated even if evaluateArithmetics is false.

Returns:

For single values, the result of the arithmetic expression or function. For a list, a copy of the list where the arithmetic expressions and functions have been replaced with their evaluated values.

replaceVariables

SassListItem replaceVariables(Collection<VariableNode> variable)

Returns a new item that is otherwise equal to this one but all occurrences of the given variables have been replaced by the values given in the VariableNodes. Does not modify this item.

Parameters:

variables - A list of nodes. The nodes contain the names and the current values of the variables to be replaced.

Returns:

A SassListItem where all occurrences of variables have been replaced by their values.

updateUrl

void updateUrl(String prefix)

Updates all url's of this item by, e.g., adding the prefix to an url not starting with slash "/" and not containing the symbol ":". This is a mutating method, i.e. it modifies the contents of the current object.

Parameters:

prefix - The prefix to be added.

printState

String printState()

Returns a string representation of this item. See LexicalUnitImpl.printState(). For a list, the string representation contains the list items separated with the separator character of the list. No parentheses appear in the string representation of a list, for valid CSS output.

Returns:

A string representation of this item.

buildString

String buildString(Node.BuildStringStrategy strategy)

Return a string representation of this item using the given strategy of converting items to strings. See LexicalUnitImpl#buildString(BuildStringStrategy).

Parameters:

strategy - Specifies how an item is converted to a string. The strategy may use the toString- and printState-methods.

Returns:

A string representation of this string.

unquotedString

String unquotedString()

Returns a string representation of this item with surrounding quotation marks of the same type (" or ') removed. Quotation marks are only removed from a single item or a list containing a single element and only one pair of quotation marks is removed.

Returns:

An unquoted string representation of this item.

getContainedValue

@Deprecated
LexicalUnitImpl getContainedValue()

Deprecated.