Funciones de lista Sass

Funciones de lista Sass

列表函数用于访问列表中的值、组合列表以及向列表添加项目。

Sass 列表是不可变的(它们无法改变)。因此,返回列表的列表函数会返回新列表,而不会更改原始列表。

Sass 列表是基于 1 的。列表中的第一个列表项位于索引 1,而不是 0。

下面列出了 Sass 中的所有列表函数:

function description & example
append(lista, valor, [separator])

将单个值添加到列表的末尾。
分隔符可以是 auto、comma 或 space。auto 是默认值。

Ejemplo:

append((a b c), d)

result: a b c d

append((a b c), (d), comma)

result: a, b, c, d

index(lista, valor)

返回列表中值的索引位置。

Ejemplo:

index(a b c, b)

result: 2

index(a b c, f)

result: null

is-bracketed(lista)

检查列表是否有方括号。

Ejemplo:

is-bracketed([a b c])

result: true

is-bracketed(a b c)

result: false

join(list1, list2, [separator, bracketed)]

list2 附加到 list1 的末尾。
分隔符可以是 auto、comma 或 space。
auto 是默认值(将使用第一个列表中的分隔符)。
bracketed 它可以是一个 auto、true 或 false。auto 是默认值。

Ejemplo:

join(a b c, d e f)

result: a b c d e f

join((a b c), (d e f), comma)

result: a, b, c, d, e, f

join(a b c, d e f, $bracketed: true)

Resultados: [a b c d e f]

length(lista)

Devuelve la longitud de la lista.

Ejemplo:

length(a b c)

Resultados: 3

list-separator(lista)

Devuelve el separador de lista utilizado en forma de cadena. Puede ser espacio o coma.

Ejemplo:

list-separator(a b c)

Resultados: "espacio"

list-separator(a, b, c)

Resultados: "coma"

nth(lista, n)

Devuelve el elemento n de la lista.

Ejemplo:

nth(a b c, 3)

Resultados: c

set-nth(lista, n, valor)

Establecer el elemento de lista n como el valor especificado.

Ejemplo:

set-nth(a b c, 2, x)

Resultados: a x c

zip(lists)

Combinar listas en una lista multidimensional.

Ejemplo:

zip(1px 2px 3px, sólido rayado punteado, rojo verde azul)

Resultados: 1px sólido rojo, 2px rayado verde, 3px punteado azul