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 | — | Список значений. |
$separator | string | '' | Разделитель элементов в полученной строке. |
Возвращаемое значение:
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
Удаляет элемент из списка по переданному индексу.
Параметры:
Name | Type | Default | Description |
---|---|---|---|
$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-at | number | -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)