Templates são arquivos que misturam HTML com lógica simples.
Eles geram páginas dinâmicas sem repetir código manualmente.
Primeiramente, um template recebe dados do backend e os exibe.
Por exemplo, {{ nome }} mostra o nome do usuário.
Além disso, templates suportam loops e condicionais básicos.
Assim, você consegue criar páginas ricas sem esforço repetitivo.
Portanto, os dados se conectam ao HTML de forma direta.
Quando utilizar templates? Em aplicações web com renderização no servidor.
Também em e-mails HTML, relatórios ou documentos gerados dinamicamente.
Python oferece dois sistemas principais: Jinja2 e Django Templates.
Ambos são maduros, seguros e extensíveis.
Então, vamos explorar suas características, diferenças e usos ideais.
Três subtítulos guiarão sua jornada pelo mundo dos templates.
Ao final, você saberá qual escolher para cada projeto.
Jinja2: flexível e multiplataforma
Jinja2 é o template engine mais popular fora do Django.
Ele é usado pelo Flask, FastAPI, e muitas outras ferramentas.
Quando usar Jinja2? Em projetos Flask ou em qualquer aplicação Python.
Também é excelente para gerar código, e-mails ou arquivos de configuração.
Primeiro, instale com pip install jinja2.
Depois, crie templates com extensão .html ou .j2.
A sintaxe é limpa e poderosa.
Por exemplo, herança de templates funciona através de blocos nomeados.
Além disso, você pode adicionar filtros personalizados facilmente.
Exemplo completo de uso do Jinja2:
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 |
# Arquivo: template_exemplo.j2 <!DOCTYPE html> <html> <head> <title>{{ titulo }}</title> </head> <body> <h1>Olá, {{ usuario.nome }}!</h1> <ul> {% for item in lista %} <li>{{ loop.index }} - {{ item }}</li> {% endfor %} </ul> {% if usuario.logado %} <p>Você está logado desde {{ usuario.login_em.strftime('%d/%m/%Y') }}</p> {% else %} <a href="/login">Faça login</a> {% endif %} {{ texto | upper | truncate(100) }} </body> </html> # Arquivo: app.py (uso com Flask ou puro) from jinja2 import Environment, FileSystemLoader from datetime import datetime # Configurar o ambiente de templates env = Environment(loader=FileSystemLoader('templates')) # Dados para o template dados = { 'titulo': 'Página Inicial', 'usuario': { 'nome': 'Ana Silva', 'logado': True, 'login_em': datetime(2025, 1, 15, 14, 30) }, 'lista': ['Python', 'Jinja2', 'Templates', 'Web'], 'texto': 'Este é um texto bem longo que será truncado pelo filtro.' } # Renderizar o template template = env.get_template('template_exemplo.j2') html_gerado = template.render(**dados) print(html_gerado) # Ou envie como resposta HTTP |
Jinja2 suporta filtros (como upper, truncate) e macros.
Ele também permite funções personalizadas no ambiente.
Portanto, é extremamente flexível para qualquer necessidade.
Django templates: integrado e seguro
Django Templates é o sistema nativo do framework Django.
Ele é mais restritivo que o Jinja2 por razões de segurança.
Quando usar Django Templates? Em projetos Django exclusivamente.
A integração é perfeita e não requer configuração extra.
A sintaxe é similar ao Jinja2, mas com diferenças sutis.
Por exemplo, usa {% %} para lógica e {{ }} para variáveis.
Além disso, os filtros também usam o pipe como separador.
Exemplo de template Django:
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 |
<!-- templates/produtos/lista.html --> {% extends "base.html" %} {% block title %}Lista de Produtos{% endblock %} {% block content %} <h2>Produtos disponíveis</h2> {% if produtos %} <table> <tr><th>Nome</th><th>Preço</th><th>Estoque</th></tr> {% for produto in produtos %} <tr> <td>{{ produto.nome }}</td> <td>R$ {{ produto.preco|floatformat:2 }}</td> <td> {% if produto.estoque > 0 %} {{ produto.estoque }} {% else %} <span style="color:red">Esgotado</span> {% endif %} </td> </tr> {% empty %} <tr><td colspan="3">Nenhum produto cadastrado</td></tr> {% endfor %} </table> {% else %} <p>Carregando produtos...</p> {% endif %} {% endblock %} # views.py (Django) from django.shortcuts import render from .models import Produto def lista_produtos(request): produtos = Produto.objects.all() return render(request, 'produtos/lista.html', {'produtos': produtos}) |
Django Templates têm tags embutidas como {% url %} e {% csrf_token %}.
Eles são mais lentos que Jinja2, mas perfeitamente adequados para 99% dos casos.
A segurança contra XSS funciona automaticamente de forma rigorosa.
Jinja2 vs. django templates: qual escolher?
Jinja2 é mais rápido e flexível que Django Templates. Ele permite chamar funções Python diretamente no template. Django Templates são mais seguros e restritivos por design. Quando escolher Jinja2? Em projetos Flask, FastAPI ou fora do Django. Também quando você precisa de máxima liberdade sintática. Django Templates são ideais para projetos Django puros. A fórmula de performance pode ajudar na decisão: \(P = \frac{T_{\text{Django}}}{T_{\text{Jinja2}}} \approx 1.5\) Portanto, Jinja2 é cerca de 50% mais rápido. No entanto, para a maioria das aplicações, a diferença é irrelevante. Ambos suportam herança, includes e filtros. Então, a escolha depende principalmente do seu framework principal. Se você usa Django, fique com Django Templates. Se usa Flask ou FastAPI, escolha Jinja2. Para projetos que geram e-mails ou relatórios, Jinja2 é mais versátil. Domine os dois e você estará preparado para qualquer cenário. Comece com o template engine do seu framework preferido. Depois, explore o outro para ampliar seus horizontes.