Sass 列表函数

Sass 列表函数

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

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

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

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

函数 描述 & 例子
append(list, value, [separator])

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

实例:

append((a b c), d)

结果:a b c d

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

结果:a, b, c, d

index(list, value)

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

实例:

index(a b c, b)

结果:2

index(a b c, f)

结果:null

is-bracketed(list)

检查列表是否有方括号。

实例:

is-bracketed([a b c])

结果:true

is-bracketed(a b c)

结果:false

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

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

实例:

join(a b c, d e f)

结果:a b c d e f

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

结果:a, b, c, d, e, f

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

结果:[a b c d e f]

length(list)

返回列表的长度。

实例:

length(a b c)

结果:3

list-separator(list)

以字符串形式返回所用的列表分隔符。可以是 space 或 comma。

实例:

list-separator(a b c)

结果:"space"

list-separator(a, b, c)

结果:"comma"

nth(list, n)

返回列表中的第 n 个元素。

实例:

nth(a b c, 3)

结果:c

set-nth(list, n, value)

将第 n 个列表元素设置为指定的值。

实例:

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

结果:a x c

zip(lists)

将列表组合成单个多维列表。

实例:

zip(1px 2px 3px, solid dashed dotted, red green blue)

结果:1px solid red, 2px dashed green, 3px dotted blue