SassArgumentList
Hierarchy
- SassList
- SassArgumentList
Index
Constructors
Accessors
Methods
Constructors
constructor
- new
Sass Argument List(contents: Value[] | List<Value>, keywords: Record<string, Value> | OrderedMap<string, Value>, separator?: ListSeparator): SassArgumentList -
Creates a new argument list.
Parameters
-
contents: Value[] | List<Value>
The positional arguments that make up the primary contents of the list. This may be either a plain JavaScript array or an immutable List from the
immutable
package. -
keywords: Record<string, Value> | OrderedMap<string, Value>
The keyword arguments attached to this argument list, whose names should exclude
$
. This can be either a plain JavaScript object with argument names as fields, or an immutable OrderedMap from theimmutable
package -
Optional
separator: ListSeparatorThe separator for this list. Defaults to
','
.
Returns SassArgumentList
-
Accessors
as List
- get asList(): List<Value>
-
This value as a list.
All SassScript values can be used as lists. Maps count as lists of pairs, and all other values count as single-value lists.
Returns List<Value>
An immutable List from the
immutable
package.
has Brackets
- get hasBrackets(): boolean
-
Whether this value as a list has brackets.
All SassScript values can be used as lists. Maps count as lists of pairs, and all other values count as single-value lists.
Returns boolean
is Truthy
- get isTruthy(): boolean
-
Whether the value counts as
true
in an@if
statement and other contexts.Returns boolean
keywords
- get keywords(): OrderedMap<string, Value>
-
The keyword arguments attached to this argument list.
The argument names don't include
$
.Returns OrderedMap<string, Value>
An immutable OrderedMap from the
immutable
package.
real Null
Methods
assert Boolean
- assert
Boolean(name?: string): SassBoolean -
Throws if
this
isn't a SassBoolean.⚠️ Atenção!
Functions should generally use isTruthy rather than requiring a literal boolean.
Parameters
-
Optional
name: stringThe name of the function argument
this
came from (without the$
) if it came from an argument. Used for error reporting.
Returns SassBoolean
-
assert Calculation
- assert
Calculation(name?: string): SassCalculation -
Throws if
this
isn't a SassCalculation.Parameters
-
Optional
name: stringThe name of the function argument
this
came from (without the$
) if it came from an argument. Used for error reporting.
Returns SassCalculation
-
assert Color
assert Function
- assert
Function(name?: string): SassFunction -
Throws if
this
isn't a SassFunction.Parameters
-
Optional
name: stringThe name of the function argument
this
came from (without the$
) if it came from an argument. Used for error reporting.
Returns SassFunction
-
assert Map
assert Mixin
assert Number
- assert
Number(name?: string): SassNumber -
Throws if
this
isn't a SassNumber.Parameters
-
Optional
name: stringThe name of the function argument
this
came from (without the$
) if it came from an argument. Used for error reporting.
Returns SassNumber
-
assert String
- assert
String(name?: string): SassString -
Throws if
this
isn't a SassString.Parameters
-
Optional
name: stringThe name of the function argument
this
came from (without the$
) if it came from an argument. Used for error reporting.
Returns SassString
-
equals
get
- get(index: number): undefined | Value
-
Returns the value at index
index
in this value as a list, orundefined
ifindex
isn't valid for this list.All SassScript values can be used as lists. Maps count as lists of pairs, and all other values count as single-value lists.
This is a shorthand for
this.asList.get(index)
, although it may be more efficient in some cases.⚠️ Atenção!
This method uses the same indexing conventions as the
immutable
package: unlike Sass the index of the first element is 0, but like Sass negative numbers index from the end of the list.Parameters
-
index: number
Returns undefined | Value
-
hash Code
sass Index To List Index
- sass
Index To List Index(sassIndex: Value, name?: string): number -
Converts
sassIndex
into a JavaScript-style index into the list returned by asList.Sass indexes are one-based, while JavaScript indexes are zero-based. Sass indexes may also be negative in order to index from the end of the list.
Throws
Error
IfsassIndex
isn't a number, if that number isn't an integer, or if that integer isn't a valid index for asList.Parameters
-
sassIndex: Value
The Sass-style index into this as a list.
-
Optional
name: stringThe name of the function argument
sassIndex
came from (without the$
) if it came from an argument. Used for error reporting.
Returns number
-
Sass's argument list type.
An argument list comes from a rest argument. It's distinct from a normal SassList in that it may contain a keyword map as well as the positional arguments.