Теги итераций

for

Неоднократно выполняет блок кода. Полный список атрибутов, доступных в forцикле, см. в разделе forloop.
Тег итерации for можно использовать для перебора многомерных массивов.
Пример
{% for demand in demands %}
Отгрузка номер {{ demand.name }}
{% endfor %}
Вывод
Отгрузка номер 0001
Отгрузка номер 0002
В примере выше, мы перебираем все отгрузки demand в массиве demands и выводим их названия c помощью массива {{ demand.name }}
Пример
{% for demand in demands %}
{% for attribute in demand.attributes %}
Отгрузка номер {{ demand.name }} - Доп. поле {{ attribute.name }}
{% endfor %}
{% endfor %}
Вывод
Отгрузка номер 0001 - Доп. поле 1
Отгрузка номер 0001 - Доп. поле 2
Отгрузка номер 0002 - Доп. поле 1
Отгрузка номер 0002 - Доп. поле 2
Теги итератора могут быть вложенными. Например, выше мы перебираем все отгрузки demand в массиве demands, а для каждой отгрузки demand перебираем массив названий доп. полей {{ attributes }}
Пример
{% for demand in demands %}
{% for invoiceOut in demand.invoicesOut %}
{% for attribute in invoiceOut.attributes %}
{% if attribute.name == "Нужное доп. поле" %}
{{ attribute.value }}
{% endif %}
{% endfor %}
{% endfor %}
{% endfor %}
Вложенность тегов итерации for .неограничyна. Внутри тега фор можно использовать теги проверки условия if

break

Заставляет цикл прекращать итерации, когда встречает breakтег.
Пример:
{% for i in (1..5) %}
{% if i == 4 %}
{% break %}
{% else %}
{{ i }}
{% endif %}
{% endfor %}
Вывод
1 2 3

continue

Заставляет цикл пропустить текущую итерацию при обнаружении continueтега.
Пример:
{% for i in (1..5) %}
{% if i == 4 %}
{% continue %}
{% else %}
{{ i }}
{% endif %}
{% endfor %}
Вывод
1 2 3 5

Параметры тега for

limit

Ограничивает выход из цикла for до определенного индекса.
Пример:
Стоимость первых трех позиций заказа:
{% for position in positions limit:4 %}
{{ position.price }} руб.
{% endfor %}
Вывод
Стоимость первых двух позиций заказа:
100 руб.
200 руб.
300 руб.

offset

Запускает цикл for с определенного индекса.
Пример:
Стоимость позиций заказа, кроме первых двух:
{% for position in positions limit:2 %}
{{ position.price }} руб.
{% endfor %}
Вывод
Стоимость позиций заказа, кроме первых двух:
300 руб.
400 руб.
500 руб.
range
Определяет диапазон чисел для цикла. Вы можете определить диапазон, используя как буквальные, так и переменные значения.
Пример:
{% for i in (3..5) %}
{{ i }}
{% endfor %}
{% assign my_limit = 4 %}
{% for i in (1..my_limit) %}
{{ i }}
{% endfor %}
Вывод
3 4 5
1 2 3 4

forloop

forloop - объект, который содержит атрибуты своего цикла for
forloop может быть использован только в пределах тегов for

forloop.first

Возвращает, trueесли это первая итерация цикла for. Возвращает, falseесли это не первая итерация.
Пример:
{% for contactperson in agent.contactpersons %}
{% if forloop.first == true %}
Первое контактное лицо компании - {{ contactperson.phone }}
{% else %}
Остальные контактные лица компании - {{ contactperson.phone }}
{% endif %}
{% endfor %}
Вывод
Первое контактное лицо компании - Иванов Иван!
Остальные контактные лица компании - Петров Петр.
Остальные контактные лица компании - Семенов Семен.

forloop.index

Возвращает текущий индекс цикла for, начиная с 1.
Пример:
{% for account in organization.accounts %}
{{ forloop.index }}-й счет компании: {{ account.accountNumber }}
{% endfor %}
Вывод
1-й счет компании: 1234567890
2-й счет компании: 0987654321
3-й счет компании: 1231231231

forloop.index0

Возвращает текущий индекс цикла for, начиная с 0.
Пример:
{% for account in organization.accounts %}
{{ forloop.index }}-й счет компании: {{ account.accountNumber }}
{% endfor %}
Вывод
0-й счет компании: 1234567890
1-й счет компании: 0987654321
2-й счет компании: 1231231231

forloop.last

Возвращает, trueесли это последняя итерация цикла for. Возвращает, falseесли это не последняя итерация.
Пример:
Телефоны менеджеров контрагента:
{% for contactperson in agent.contactpersons %}
{{contactperson.name }} - {{contactperson.phone }}
{% if forloop.last != true %}
,
{% endif %}
{% endfor %}
Вывод
Телефоны менеджеров контрагента:
Иванов Иван - 89991112233, Петров Петр - 89000000000,
Семенов Семен - 81112223344

forloop.length

Возвращает количество итераций цикла.
Пример:
{% for payment in payments %}
{% if forloop.first %}
По заказу {{ forloop.length }} платежа на сумму:
{% endif %}
{{ payment.sum }} {{rate.name}}
{% endfor %}
Вывод
По заказу 2 платежа на сумму:
1000 руб
2000 руб
3000 руб

forloop.rindex

Возвращает forloop.index в обратном порядке.
Пример:
{% for invoiceOut in invoicesOut %}
{{ forloop.rindex }}-й счет - номер {{ invoiceOut.name }}
{% endfor %}
Вывод
3-й счет - номер 3
2-й счет - номер 2
1-й счет - номер 1

forloop.rindex0

Возвращает forloop.index0 в обратном порядке.
Пример
{% for invoiceOut in invoicesOut %}
{{ forloop.rindex0 }}-й счет - номер {{ invoiceOut.name }}
{% endfor %}
Вывод
3-й счет - номер 3
2-й счет - номер 2
1-й счет - номер 1
0-й счет - номер 0

cycle

Перебирает группу строк и выводит их в том порядке, в котором они были переданы в качестве параметров. При каждом вызове cycleвыводится следующая строка, переданная в качестве параметра.
cycleдолжен использоваться внутри блока for
Пример
{% cycle 'one', 'two', 'three' %}
{% cycle 'one', 'two', 'three' %}
{% cycle 'one', 'two', 'three' %}
{% cycle 'one', 'two', 'three' %}
Вывод
one
two
three
one