render_template e a pasta templates
Retorne um arquivo HTML em vez de uma string.
render_template e a pasta templates é uma aula grátis de Flask Academy no CoddyKit. Esta é a aula 1 de 4. Você pode ler a aula completa abaixo gratuitamente — depois pratica ao vivo no navegador com um editor de código integrado e um tutor de IA 24/7. Faz parte do caminho de aprendizado de Flask Academy, e seu progresso é sincronizado entre a web e o app CoddyKit. O curso de Flask Academy inclui 4 aulas no total.
De Strings a Páginas
Até agora, suas rotas retornavam strings simples. Páginas reais precisam de HTML, e o Flask fornece render_template para servir arquivos HTML completos de forma organizada.
O Que render_template Faz
render_template encontra um arquivo HTML, processa-o pelo mecanismo de modelos e retorna a página pronta como corpo da resposta.
from flask import render_template
@app.route('/')
def home():
return render_template('index.html')A Pasta de Modelos
O Flask procura seu HTML em uma pasta chamada templates, ao lado do arquivo da aplicação. Coloque index.html nela e o Flask o encontrará automaticamente. 📁
myapp/
app.py
templates/
index.htmlPor Que Usar um Nome Fixo
O nome templates é uma convenção, não um palpite. O Flask sabe onde procurar, então você nunca precisa escrever o caminho da pasta dentro de render_template.
Referencie Apenas o Nome do Arquivo
Você informa apenas o nome do arquivo, não o caminho completo. O Flask o acrescenta à pasta de modelos, mantendo seu código curto e portável.
return render_template('about.html')Subpastas Dentro de templates
Você pode agrupar páginas em subpastas e referenciá-las usando barras. Isso mantém um projeto grande organizado à medida que ele cresce.
return render_template('users/profile.html')Um Modelo Mínimo
Um modelo é, em essência, um HTML comum. O modelo mais simples é apenas uma página normal, ainda sem sintaxe especial.
<!doctype html>
<title>Home</title>
<h1>Welcome</h1>Os Modelos São Processados
Até mesmo um arquivo simples é processado: o Flask o executa primeiro pelo Jinja2. É isso que permitirá adicionar partes dinâmicas depois.
Retornando o Resultado
render_template retorna uma string de HTML, que você retorna da sua visualização. O Flask a envolve em uma resposta adequada, com o tipo de conteúdo correto.
@app.route('/')
def home():
return render_template('index.html')Erros TemplateNotFound
Se o Flask não encontrar o arquivo, você receberá um erro TemplateNotFound. Verifique a grafia e confirme que o arquivo está realmente dentro de templates.
Separando Lógica e Marcação
Os modelos mantêm o HTML fora do Python. As visualizações cuidam da lógica, os modelos cuidam da apresentação, e essa separação facilita muito a leitura de ambos.
Verificação Rápida
Onde o Flask espera encontrar seus arquivos HTML por padrão?
Recapitulação
Você aprendeu que render_template serve HTML da pasta de modelos pelo nome do arquivo, mantendo a lógica no Python e a marcação nos arquivos. Muito bem! 🎉
Aprenda Python com um tutor de IA — grátis
Escreva e execute código real no seu navegador, obtenha ajuda instantânea de um tutor de IA 24/7 e continue de onde parou na web ou no app.
- Cursos
- 30
- Aulas
- 120
Perguntas Frequentes
A aula “render_template e a pasta templates” é grátis?
Sim — o texto completo de “render_template e a pasta templates” é grátis para ler aqui na web. Para praticá-la interativamente (um editor de código integrado e um tutor de IA 24/7) e desbloquear o restante do curso de Flask Academy, atualize para CoddyKit PRO. O curso de Flask Academy inclui 4 aulas no total.
O que vou aprender em “render_template e a pasta templates”?
Retorne um arquivo HTML em vez de uma string. Você pratica Flask Academy com código prático que executa diretamente no navegador, e um tutor de IA 24/7 responde suas dúvidas enquanto trabalha na aula.
Preciso ter experiência prévia para começar Flask Academy?
Nenhuma experiência prévia é necessária. Flask Academy no CoddyKit é estruturado para alunos iniciantes até avançados, então você pode começar aqui ou desde o início e aprender no seu ritmo. Esta é a aula 1 de 4.
Quanto tempo leva a aula “render_template e a pasta templates”?
A maioria das aulas CoddyKit leva cerca de 5–10 minutos. Cada uma é compacta e interativa, então você faz progresso constante e retoma exatamente de onde parou entre web e app.
Posso escrever e executar código nesta aula de Flask Academy?
Sim. Cada aula de Flask Academy inclui um editor de código integrado, então você escreve e executa código real direto no navegador e recebe feedback de IA instantaneamente — nenhuma configuração local necessária.
Todas as aulas deste curso
- render_template e a pasta templates
- Passe dados para um modelo
- Laços e condicionais do Jinja2
- Escape automático e o filtro safe