クイックリファレンス

Jinja & Jinja2 テンプレート チートシート

Python / Flask 用 Jinja テンプレート構文のクイックリファレンス:変数展開、フィルター、制御構文(条件分岐・ループ)、テンプレート継承を解説。

· 公開日

Jinja は、Flask や Ansible で広く使われている高速・表現力豊かで拡張性の高い Python 用テンプレートエンジンです。

構文デリミタ

{% ... %}  # 制御構文(ループ、条件分岐、ブロック定義)
{{ ... }}  # 評価されてテンプレート出力へ展開される式
{# ... #}  # テンプレートコメント(最終出力からは除外)

変数とフィルター

<h1>Hello {{ user.name | capitalize }}</h1>
<p>{{ article.body | truncate(150) | safe }}</p>
<p>Items count: {{ items | length }}</p>

よく使われるフィルター: capitalize, lower, upper, title, trim, striptags, join, default, safe.

制御構造

条件分岐

{% if user.is_authenticated %}
  <p>Welcome back, {{ user.name }}!</p>
{% elif user.is_invited %}
  <p>Please complete your registration.</p>
{% else %}
  <a href="/login">Sign in</a>
{% endif %}

ループ処理

<ul>
{% for item in items %}
  <li class="{{ 'odd' if loop.odd else 'even' }}">
    {{ loop.index }}: {{ item.title }}
  </li>
{% else %}
  <li>No items available.</li>
{% endfor %}
</ul>

ループヘルパー:loop.index(1始まり)、loop.index0(0始まり)、loop.first、loop.last、loop.length。

テンプレート継承

ベースレイアウト (base.html):

<!DOCTYPE html>
<html>
<head><title>{% block title %}My Site{% endblock %}</title></head>
<body>
  <main>{% block content %}{% endblock %}</main>
</body>
</html>

子テンプレート:

{% extends "base.html" %}
{% block title %}Dashboard - My Site{% endblock %}
{% block content %}
  <h1>Welcome to your Dashboard</h1>
{% endblock %}

参考リンク

関連テーマ