list

Категория функций для работы со списками значений.

list-contains

Проверяет, содержит ли хотя бы одно значение в переданном списке искомую подстроку.

Параметры:

ИмяТипПо умолчаниюОписание
$list *listСписок значений.
$search *stringИскомая подстрока.

Возвращаемое значение:

bool - true, если одно из значений в переданном списке содержит искомую подстроку, false в ином случае.

Пример использования:

@use 'more-sass' as more;

$list: ('foo', 'bar', 'baz');

@debug more.list-contains($list, 'ba');  // bool: true
@debug more.list-contains($list, 'abc'); // bool: false

list-includes

Проверяет, присутствует ли искомое значение в переданном списке.

Параметры:

ИмяТипПо умолчаниюОписание
$list *listСписок значений.
$search **Искомое значение.

Возвращаемое значение:

bool - true, если искомое значение присутствует в переданном списке, false в ином случае.

Пример использования:

@use 'more-sass' as more;

$list: (1, 2, 3);

@debug more.list-includes($list, 2); // bool: true
@debug more.list-includes($list, 4); // bool: false

list-join

Объединяет элементы переданного списка значений в строку.

Параметры:

ИмяТипПо умолчаниюОписание
$list *listСписок значений.
$separatorstring''Разделитель элементов в полученной строке.

Возвращаемое значение:

string - Строка, содержащая строковое представление всех элементов массива в том же порядке, с разделителем между каждым элементом.

Пример использования:

@use 'more-sass' as more;

@debug more.list-join((1, 2, 3, 4, 5));    // string: '12345'
@debug more.list-join((1, 2, 3, 4), ', '); // string: '1, 2, 3, 4'

list-remove

Удаляет элемент из списка по переданному индексу.

Параметры:

NameTypeDefaultDescription
$list *listСписок значений.
$index *numberИндекс элемента для удаления.
Используйте негативное значение для удаления с конца списка.

Возвращаемое значение:

list - Список без элемента с указанным индексом, если он найден, иначе - клон оригинального списка.

Пример использования:

@use 'more-sass' as more;

@debug more.list-remove((1, 2, 3), 1);   // list: (2, 3)
@debug more.list-remove((1, 2, 3), -1);  // list: (1, 2)
@debug more.list-remove((1, 2, 3), 100); // list: (1, 2, 3)

list-slice

Выбирает срез переданного списка значений.

Параметры:

ИмяТипПо умолчаниюОписание
$list *listСписок значений.
$start-at *numberПозиция начала среза (включительно).
$end-atnumber-1Позиция окончания среза (включительно).

Возвращаемое значение:

list - Срез переданного списка значений.

Пример использования:

@use 'more-sass' as more;

@debug more.list-slice((1, 2, 3, 4, 5), 3); // list: (3, 4, 5)
@debug more.list-slice((1, 2, 3, 4, 5), 2, 4); // list: (2, 3, 4)