[structures] Jinja - include (인클루드: 삽입하기)

include (인클루드)

 

1.

include 태그는 다른 템플릿을 렌더링하고 그 결과를 현재 템플릿에 출력함.

 

{% include 'header.html' %}

Body goes here.

{% include 'footer.html' %}

 

2.

• include 된 템플릿은 기본적으로 현재 템플릿의 컨텍스트에 접근 가능함. 대신 별도의 컨텍스트를 사용하려면 컨텍스트 없이 사용. with context도 유효하지만 기본 동작임. Import Context Behavior 참조. 
• include 된 템플릿은 다른 템플릿을 확장하고 그 템플릿의 블록을 재정의 가능함. 그러나 현재 템플릿은 include 된 템플릿이 출력하는 어떠한 블록도 재정의할 수 없음. 
• include 하려는 템플릿이 존재 안 할 경우 명령문 무시 위해 ignore missing 지시어 사용. (context 가시성 지시어 보다 앞에 배치해야 함.)

{% include "sidebar.html" without context %}

{% include "sidebar.html" ignore missing %}

{% include "sidebar.html" ignore missing with context %}

{% include "sidebar.html" ignore missing without context %}

 

3.

• 템플릿 목록이 제공되면 하나가 누락되지 않을 때까지 각 템플릿이 순서대로 시도됨. 
• 템플릿이 없는 경우 무시하기 위해 ignore missing 지시어와 함께 사용할 수 있음.

{% include ['page_detailed.html', 'page.html'] %}

{% include ['special_sidebar.html', 'sidebar.html'] ignore missing %}

 

4.

템플릿 이름이나 템플릿 개체가 포함된 변수를 include 문에 전달할 수도 있음.

 

공식 매뉴얼: 

https://jinja.palletsprojects.com/en/3.1.x/templates/#include