[filters] Jinja - map() 필터 - 각 아이템에 필터 적용하거나 속성 조회 (= map필터 = 맵필터)

1. map() 예제 - 각 아이템에 필터 적용하거나 속성 조회
2. map() 정의
3. map() 구문

map() 예제 - 각 아이템에 필터 적용하거나 속성 조회

[예제1] - 특정 속성의 값 리스트 출력

{% set users = [{'username': 'user1'}, {'username': 'user2'}, {'username': 'user3'}] %}

{{ users|map(attribute='username')|join(', ') }}

결과값: user1, user2, user3

---

[예제2] - 특정 속성 없는 객체에 기본값 적용

 

{% set users = [{'username': 'user1'}, {'name': 'user2'}, {'username': 'user3'}] %}

{{ users|map(attribute="username", default="Anonymous")|join(", ") }}

 

결과값: user1, Anonymous, user3

---

[예제3] - 각 객체에 특정 필터 적용

 

{% set titles = ['Title 1', 'Title 2', 'Title 3'] %}

{{ titles|map('lower')|join(', ') }}

 

결과값: title 1, title 2, title 3 

map() 정의

 

일련의 객체에 필터를 적용하거나 속성을 조회하는 필터.

 

---

 

1.

• 이는 객체 목록을 처리할 때 유용하지만, 실제로는 객체의 특정 값에만 관심이 있음.
• 사용법1 - 속성에 대한 매핑임. 사용자 목록의 사용자 이름에만 관심이 있다고 가정. (예) {{ users|map(attribute='username')|join(', ') }}
• 사용법2 - 목록의 객체에 지정 속성 없을 시 사용할 기본값 지정. (예) {{ users|map(attribute="username", default="Anonymous")|join(", ") }}
• 사용법3 - 필터명과 인수를 전달해 필터 호출 가능. 예를 들어, 각 객체에 소문자 변환 필터 적용. (예) {{ titles|map('lower')|join(', ') }}

 

2. 다음과 같은 generator 이해와 유사.

(u.username for u in users)

(getattr(u, "username", "Anonymous") for u in users)

(do_lower(x) for x in titles)

 

3.

• jinja2 2.11.0 - default 매개변수가 추가됨. 
• jinja2 2.7 +

 

4. 공식 매뉴얼

https://jinja.palletsprojects.com/en/3.1.x/templates/#jinja-filters.map

 

map() 구문

 

jinja-filters.map(value: Iterable, *args: Any, **kwargs: Any) → Iterable