sass:list

list.append($list, $val, $separator: auto)
append($list, $val, $separator: auto) //=> list 

返回的副本$list与$val添加到末尾。

如果$separator为comma，则返回的列表以逗号分隔。如果为space，则返回的列表以空格分隔。如果是auto（默认值），则返回列表将使用与$list（或space如果$list没有分隔符）相同的分隔符。不允许使用其他值。

请注意，与是列表不同的是list.join()，$val它嵌套在返回列表中，而不是将其所有元素添加到返回列表中。

@debug list.append(10px 20px, 30px); // 10px 20px 30px
@debug list.append((blue, red), green); // blue, red, green
@debug list.append(10px 20px, 30px 40px); // 10px 20px (30px 40px)
@debug list.append(10px, 20px, $separator: comma); // 10px, 20px
@debug list.append((blue, red), green, $separator: space); // blue red green

@debug list.append(10px 20px, 30px)  // 10px 20px 30px
@debug list.append((blue, red), green)  // blue, red, green
@debug list.append(10px 20px, 30px 40px)  // 10px 20px (30px 40px)
@debug list.append(10px, 20px, $separator: comma)  // 10px, 20px
@debug list.append((blue, red), green, $separator: space)  // blue red green

list.index($list, $value)
index($list, $value) //=> number | null 

返回指数的$value在  $list。

如果$value未出现$list，则返回null。如果在中$value出现多次$list，则返回其第一次出现的索引。

@debug list.index(1px solid red, 1px); // 1
@debug list.index(1px solid red, solid); // 2
@debug list.index(1px solid red, dashed); // null

@debug list.index(1px solid red, 1px)  // 1
@debug list.index(1px solid red, solid)  // 2
@debug list.index(1px solid red, dashed)  // null

list.is-bracketed($list)
is-bracketed($list) //=> boolean 

返回是否$list有方括号。

@debug list.is-bracketed(1px 2px 3px); // false
@debug list.is-bracketed([1px, 2px, 3px]); // true

@debug list.is-bracketed(1px 2px 3px)  // false
@debug list.is-bracketed([1px, 2px, 3px])  // true

list.join($list1, $list2, $separator: auto, $bracketed: auto)
join($list1, $list2, $separator: auto, $bracketed: auto) //=> list 

返回包含元素的新列表，$list1后跟的元素  $list2。

如果$separator为comma，则返回的列表以逗号分隔。如果为space，则返回的列表以空格分隔。如果是auto（默认值），则返回的列表将使用相同的分隔符，就$list1好像它具有分隔符一样，或者$list2如果它具有分隔符，或者否则space。不允许使用其他值。

如果$bracketed为true，则返回的列表带有方括号。如果为false，则返回的列表没有括号。如果是auto（默认），则返回列表将放在括号$list1中。不允许使用其他值。

@debug list.join(10px 20px, 30px 40px); // 10px 20px 30px 40px
@debug list.join((blue, red), (#abc, #def)); // blue, red, #abc, #def
@debug list.join(10px, 20px); // 10px 20px
@debug list.join(10px, 20px, $separator: comma); // 10px, 20px
@debug list.join((blue, red), (#abc, #def), $separator: space); // blue red #abc #def
@debug list.join([10px], 20px); // [10px 20px]
@debug list.join(10px, 20px, $bracketed: true); // [10px 20px]

@debug list.join(10px 20px, 30px 40px)  // 10px 20px 30px 40px
@debug list.join((blue, red), (#abc, #def))  // blue, red, #abc, #def
@debug list.join(10px, 20px)  // 10px 20px
@debug list.join(10px, 20px, comma)  // 10px, 20px
@debug list.join((blue, red), (#abc, #def), space)  // blue red #abc #def
@debug list.join([10px], 20px)  // [10px 20px]
@debug list.join(10px, 20px, $bracketed: true)  // [10px 20px]

list.length($list)
length($list) //=> number 

返回的长度  $list。

这也可以返回映射中的对数。

@debug list.length(10px); // 1
@debug list.length(10px 20px 30px); // 3
@debug list.length((width: 10px, height: 20px)); // 2

@debug list.length(10px)  // 1
@debug list.length(10px 20px 30px)  // 3
@debug list.length((width: 10px, height: 20px))  // 2

list.nth($list, $n)
nth($list, $n) 

返回$listat index 的元素$n。

如果$n为负，则从开始$list。如果index处没有元素，则会引发错误  $n。

@debug list.nth(10px 12px 16px, 2); // 12px
@debug list.nth([line1, line2, line3], -1); // line3

@debug list.nth(10px 12px 16px, 2)  // 12px
@debug list.nth([line1, line2, line3], -1)  // line3

list.set-nth($list, $n, $value)
set-nth($list, $n, $value) //=> list 

返回索引为$list的元素替换  为的的副本。 $n$value

如果$n为负，则从开始$list。如果index处没有现有元素，则会引发错误  $n。

@debug list.set-nth(10px 20px 30px, 1, 2em); // 2em 20px 30px
@debug list.set-nth(10px 20px 30px, -1, 8em); // 10px, 20px, 8em
@debug list.set-nth((Helvetica, Arial, sans-serif), 3, Roboto); // Helvetica, Arial, Roboto

@debug list.set-nth(10px 20px 30px, 1, 2em); // 2em 20px 30px
@debug list.set-nth(10px 20px 30px, -1, 8em); // 10px, 20px, 8em
@debug list.set-nth((Helvetica, Arial, sans-serif), 3, Roboto); // Helvetica, Arial, Roboto

list.zip($lists...)
zip($lists...) //=> list 

将每个列表合并$lists为一个子列表。

返回列表中的每个元素都包含中该位置的所有元素$lists。返回的列表与中的最短列表一样长  $lists。

返回的列表始终以逗号分隔，子列表始终以空格分隔。

@debug list.zip(10px 50px 100px, short mid long); // 10px short, 50px mid, 100px long
@debug list.zip(10px 50px 100px, short mid); // 10px short, 50px mid

@debug list.zip(10px 50px 100px, short mid long)  // 10px short, 50px mid, 100px long
@debug list.zip(10px 50px 100px, short mid)  // 10px short, 50px mid