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
