[functions] Jinja - cycler() 함수 ★ - 교대순환 반환 (=cycler함수 = 사이클러함수) ※ cycler.current 속성 / cycler.next() 함수 / cycler.reset() 함수 ※ 얼룩말, 지불러

1. cycler() 예제 - odd/even 클래스 교대 순환 출력
2. cycler() 정의
3. cycler() 구문
4. cycler() 예제 - current, next(), reset()

cycler() 예제 - odd/even 클래스 교대 순환 출력

 

{% set folders = ['A', 'B', 'C'] %}

{% set files = ['a.txt', 'b.txt', 'c.txt'] %}

{% set row_class = cycler("odd", "even") %}

<ul class="browser">

{% for folder in folders %}

  <li class="folder {{ row_class.next() }}">{{ folder }}

{% endfor %}

{% for file in files %}

  <li class="file {{ row_class.next() }}">{{ file }}

{% endfor %}

</ul>

 

결과값:

<ul class="browser">

  <li class="folder odd">A</li>
  <li class="folder even">B</li>
  <li class="folder odd">C</li>
  <li class="file even">a.txt</li>
  <li class="file odd">b.txt</li>
  <li class="file even">c.txt</li>
</ul>

cycler() 정의

 

지정 매개변수들을 교대 순환하면서 반환하는 전역함수.

 

---

 

1.

• 한 번에 하나씩 값을 제공하여 값을 순환한 다음 끝에 도달하면 다시 시작.
• loop.cycle과 유사하지만 루프 외부 또는 여러 루프에 걸쳐 사용 가능. (예) List에 있는 폴더와 파일 목록을 렌더링하고 "odd" 클래스와 "even" 클래스를 번갈아 제공.

 

2.  cycler() 함수 반환값을 cycler 변수에 할당 시 이용 가능한 값들

• cycler.current 속성 = 현재 아이템 반환. 다음에 next()가 호출될 때 반환될 아이템과 동일.
• cycler.next() 메서드 - 현재 아이템 반환 후, current 포인터를 다음 아이템으로 이동.
• cycler.reset() 메서드 - current 포인터를 첫 번째 아이템으로 재설정. (아이템 반환 X)

 

3.

Jinja2 2.1 +

 

4. 공식 매뉴얼

https://jinja.palletsprojects.com/en/3.1.x/templates/#jinja-globals.cycler

 

cycler() 구문

 

class jinja-globals.cycler(\*items)

 

---

[매개변수]

 

\*items

교대 순환할 값을 쉼표(,)로 구분해 나열. (예) "odd", "even"

 

---

[반환값]

 

반복이 끝날 때까지 지정 매개변수 값을 교대로 반환.

 

cycler() 예제 - current, next(), reset()

 

{% set nums = cycler(1,2,3) %}

{{ nums.current }} {# 1 #}

{{ nums.next() }} {# 1 #}

{{ nums.current }} {# 2 #}

{{ nums.next() }} {# 2 #}

{{ nums.current }} {# 3 #}

{{ nums.reset() }} {# None #}

{{ nums.current }} {# 1 #}