Référence rapide

Aide-mémoire Modèles Jinja & Jinja2

Guide rapide pour la syntaxe des modèles Jinja sous Python/Flask : variables, filtres, structures de contrôle, boucles, héritage de modèles et macros.

· Publié le

Jinja est un moteur de templates rapide, expressif et extensible pour Python, largement employé dans Flask et Ansible.

Délimiteurs de syntaxe

{% ... %}  # Instructions de contrôle (boucles, conditions, blocs)
{{ ... }}  # Expressions évaluées et affichées dans la sortie du modèle
{# ... #}  # Commentaires de modèle (supprimés de la sortie finale)

Variables et filtres

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

Filtres courants : capitalize, lower, upper, title, trim, striptags, join, default, safe.

Structures de contrôle

Conditions

{% 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 %}

Boucles

<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>

Utilitaires de boucle : loop.index (à partir de 1), loop.index0 (à partir de 0), loop.first, loop.last, loop.length.

Héritage de modèles

Gabarit de base (base.html) :

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

Modèle enfant :

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

Références

Sujets associés