Sass List 函数
Sass 列表函数
List 函数用于访问列表中的值、合并列表以及向列表中添加项目。
Sass 列表是不可变的(它们不能更改)。因此,List 函数将返回一个新列表,而不会更改原始列表。
Sass 列表以 1 为基础。列表中的第一个列表项位于索引 1,而不是 0。
下表列出了 Sass 中的所有列表函数:
函数 | 描述 & 实例 |
---|---|
append(list, value, [separator]) | 将单个值 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) | 返回列表中 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 的末尾。分隔符可以是 、comma(逗号) 或 space(空格)。自动为默认值(将使用第一个列表中的分隔符)。括号中的分隔符可以是 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 |