Фильтры массивов

Фильтры массивов изменяют вывод массивов.

join

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

Результатом является одна строка.

Пример:

{{ fields | join: ', '}}

Вывод

Значение доп. поля 1, Значение доп. поля 2

Для многомерных массивов вторым параметром нужно указать значение массива, которое нужно выбрать.

Пример:

{{ attributes | join: ", ", "name" }}

Суммы отгрузок: {{ demands | join: ", ", "sum" }}
Номера платежей: {{ payments | join: ", ", "name" }}

Вывод

Доп. поле1, Доп. поле2, Доп. поле 3

Суммы отгрузок: 1000, 2000, 3000
Номера платежей: 0001, 0002, 0003

first

Возвращает первый элемент массива.

Пример:

{{ fields | first }}

Вывод

Значение доп. поля 1

Для многомерных массивов вторым параметром нужно указать значение массива, которое нужно выбрать.

{{ attributes | first: "value" }}

Сумма первой отгрузки: {{ demands | first: "sum" }}
Номер первого платежа: {{ payments | first: "name" }}

Значение доп. поля 1

Сумма первой отгрузки: 1000
Номер первого платежа: 0001

Вы можете использовать фильтр first через точку . после массива, когда вам нужно употребить его внутри тега

{% if attributes.first.name == "Накладная" %}
  {{ attributes.first.value }}
{% endif %}

{{ fields.first }}
{{ attributes.first.name }}
{{ demands.first.sum }}

last

Возвращает последний элемент массива.

Пример:

{{ fields | last }}

Вывод

Значение доп. поля 2

Для многомерных массивов вторым параметром нужно указать значение массива, которое нужно выбрать.

{{ attributes | last: "value" }}

Сумма последней отгрузки: {{ demands | last: "sum" }}
Номер последего платежа: {{ payments | last: "name" }}

Значение доп. поля 2

Сумма последней отгрузки: 1000
Номер последнего платежа: 0003

Вы можете использовать фильтр last через точку . после массива, когда вам нужно употребить его внутри тега

{% if attributes.last.name == "Накладная" %}
  {{ attributes.last.value }}
{% endif %}

{{ fields.last }}
{{ attributes.last.name }}
{{ demands.last.sum }}

concat

Объединяет массив с другим массивом. Полученный массив содержит все элементы исходных массивов. concatне удалит повторяющиеся записи из объединенного массива, если вы также не используете uniqфильтр.

Пример:

{% assign fruits = "apples, oranges, peaches, tomatoes" | split: ", " %}
{% assign vegetables = "broccoli, carrots, lettuce, tomatoes" | split: ", " %}

{% assign plants = fruits | concat: vegetables %}

{{ plants | join: ", " }}

Вывод

apples, oranges, peaches, tomatoes, broccoli, carrots, lettuce, tomatoes

Вы можете объединить несколько concatфильтров для объединения более двух массивов:

Пример:

{% assign operations = demands | concat: payments | concat: invoicesOut %}

Операции:
{% for oper in operations %}

{{ oper.meta.type}}: {{ oper.name }} - {{oper.sum }} -  {{oper.moment }}, 

{% endfor%}

Вывод

Операции:
demand: 00005 - 1000 - 07.04.2020, 
cashin: 00001 - 0 - 16.03.2020, 
paymentin: 00001 - 2000 - 16.03.2020, 
invoiceout: 00002 - 7000 - 18.03.2020,

index

Возвращает элемент в указанном месте индекса в массиве. Обратите внимание, что нумерация массивов начинается с нуля, поэтому на первый элемент массива ссылаются с [0].

Пример:

{{ attributes[2].name }}

Вывод

Третье доп. поле

map

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

Пример:

{% assign demands_sum = demands | map: 'sum' %}

{% for sum in demands_sum %}
    {% assign total_sum = total_sum | plus: sum %}
{% endfor %}

Всего отгрузок на сумму: {{ total_sum }}

Вывод

Всего отгрузок на сумму: 1000

reverse

Меняет порядок элементов в массиве.

Пример:

{% assign my_array = "apples, oranges, peaches, plums" | split: ", " %}

{{ my_array | reverse | join: ", " }}

Вывод

plums, peaches, oranges, apples

size

Возвращает размер строки (количество символов) или массива (количество элементов).

Пример:

{{ 'The quick brown fox jumps over a lazy dog.' | size }}

Вывод

42

sort

Сортирует элементы массива по заданному атрибуту элемента в массиве.копия

{% assign products = positions | sort: 'price' %}
{% for product in products %}
  {{ product.price }}
{% endfor %}

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

uniq

Удаляет любые повторяющиеся экземпляры элементов в массиве.

Пример:

{% assign fruits = "orange apple banana apple orange" %}
{{ fruits | split: ' ' | uniq | join: ' ' }}

Вывод

orange apple banana