[filters] Jinja - xmlattr() 필터 - dict의 아이템 기반으로 SGML/XML 속성 문자열 생성 (= xmlattr속성 = 엑스엠엘어트르속성)

1. xmlattr() 예제 - dict 기반으로 SGML/XML 속성 문자열 생성
2. xmlattr() 정의
3. xmlattr() 구문

xmlattr() 예제 - dict 기반으로 SGML/XML 속성 문자열 생성

 

{% set variable = 42 %}

<ul{{ {'class': 'my_list', 'missing': None,

        'id': 'list-%d'|format(variable)}|xmlattr }}>

  <li>Item 1</li>

  <li>Item 2</li>

  <li>Item 3</li>

</ul>

 

결과값:

<ul class="my_list" id="list-42">

  <li>Item 1</li>

  <li>Item 2</li>

  <li>Item 3</li>

</ul>

xmlattr() 정의

 

key:value 쌍으로 구성된 dict의 아이템 기반으로 SGML/XML 속성 문자열 생성하는 필터.

 

---

 

1.

key에 공백 포함 시 ValueError 발생해 실패함. 'none'이나 'undefined' 아닌 값들은 자동으로 이스케이프(= 위험 코드 회피처리 후 안전하게 출력) 됨.

 

<ul{{ {'class': 'my_list', 'missing': none,

        'id': 'list-%d'|format(variable)}|xmlattr }}>

...

</ul>

 

결과값:

<ul class="my_list" id="list-42">

...

</ul>

 

PS. 보시다시피 두 번째 매개 변수가 false가 아닌 이상 필터가 무언가를 반환하면 자동으로 아이템 앞에 공백이 추가됨.

 

2.

Jinja2 3.1.3 - 공백 있는 key는 비허용.

 

3. 공식 매뉴얼

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

 

xmlattr() 구문

 

jinja-filters.xmlattr(d: Mapping[str, Any], autospace: bool = True) → str

 

---

[매개변수]

 

d: Mapping[str, Any]

필수. 이 필터를 적용할 key:value 쌍의 매핑 데이터.

 

autospace: bool = True

선택. 필터 통과한 각각의 아이템 앞에 공백 추가 여부.

 

---

[반환값]

 

SGML/XML 속성 문자열 반환.