Flask 模板:使用 Jinja2 渲染 HTML

myzbx 2025-01-24 13:05 23 浏览

Flask 是一个轻量级且灵活的 Python Web 框架。其主要功能之一是能够使用强大的模板引擎 Jinja2 呈现 HTML 模板。本博客将引导您了解 Flask 模板的基础知识，并演示如何使用 Jinja2 渲染动态 HTML 内容。

什么是模板？

Flask 中的模板是包含静态 HTML 以及用于插入动态内容的特殊语法的文件。这些模板通常存储在 Flask 项目目录中名为“templates”的文件夹中。 Flask 使用 Jinja2 作为默认模板引擎，允许您在 HTML 文件中嵌入类似 Python 的表达式和逻辑。

使用 Jinja2 设置 Flask

首先，确保您的 Python 环境中安装了 Flask。您可以使用 pip 安装它：

pip install Flask

接下来，创建一个基本的 Flask 应用程序结构：

flask_app/
│
├── app.py
├── templates/
│   └── index.html
└── static/

创建一个简单的 Flask 应用程序

让我们从一个简单的 Flask 应用程序开始。创建一个名为“app.py”的文件：

from flask import Flask, render_template


app = Flask(__name__)


@app.route('/')
def home():
    return render_template('index.html', title="Home Page", message="Welcome to Flask with Jinja2!")


if __name__ == '__main__':
    app.run(debug=True)

在此示例中，“render_template”函数呈现“index.html”模板，并传入标题和消息作为变量。

创建您的第一个模板

在项目目录中创建一个名为“templates”的文件夹，并在该文件夹中创建一个名为“index.html”的文件：

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>{{ title }}</title>
</head>
<body>
    <h1>{{ message }}</h1>
    <p>This is a simple Flask application demonstrating Jinja2 templates.</p>
</body>
</html>

在此模板中，“{{ title }}”和“{{ message }}”是占位符，将被从 Flask 路由传递的值替换。

向模板添加逻辑

Jinja2 允许您添加控制结构，例如循环和条件。让我们更新我们的模板来演示这些功能：

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>{{ title }}</title>
</head>
<body>
    <h1>{{ message }}</h1>
    <p>This is a simple Flask application demonstrating Jinja2 templates.</p>
    
    <h2>Fruits List:</h2>
    <ul>
        {% for fruit in fruits %}
        <li>{{ fruit }}</li>
        {% endfor %}
    </ul>


    {% if show_greeting %}
    <p>Have a great day!</p>
    {% else %}
    <p>Goodbye!</p>
    {% endif %}
</body>
</html>

更新“app.py”以将水果列表和布尔变量传递给模板：

@app.route('/')
def home():
    fruits = ["Apple", "Banana", "Cherry", "Date", "Elderberry"]
    show_greeting = True
    return render_template('index.html', title="Home Page", message="Welcome to Flask with Jinja2!", fruits=fruits, show_greeting=show_greeting)

使用模板继承

模板继承允许您创建具有公共元素（例如页眉和页脚）的基本模板，并在其他模板中扩展它。在“templates”文件夹中创建一个基本模板“base.html”：

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>{% block title %}Default Title{% endblock %}</title>
</head>
<body>
    <header>
        <h1>My Website</h1>
    </header>
    
    <main>
        {% block content %}{% endblock %}
    </main>
    
    <footer>
        <p>(c) 2024 My Website</p>
    </footer>
</body>
</html>

现在，更新“index.html”以扩展“base.html”：

{% extends "base.html" %}


{% block title %}{{ title }}{% endblock %}


{% block content %}
    <h1>{{ message }}</h1>
    <p>This is a simple Flask application demonstrating Jinja2 templates.</p>
    
    <h2>Fruits List:</h2>
    <ul>
        {% for fruit in fruits %}
        <li>{{ fruit }}</li>
        {% endfor %}
    </ul>


    {% if show_greeting %}
    <p>Have a great day!</p>
    {% else %}
    <p>Goodbye!</p>
    {% endif %}
{% endblock %}

模板过滤器

Jinja2 允许您使用过滤器在渲染变量之前修改它的值。让我们添加一个自定义过滤器来将列表中的所有项目大写。

在“app.py”中创建自定义过滤器：

from flask import Flask, render_template


app = Flask(__name__)


# Custom filter
def capitalize_list(items):
    return [item.capitalize() for item in items]


app.jinja_env.filters['capitalize'] = capitalize_list


@app.route('/')
def home():
    fruits = ["apple", "banana", "cherry", "date", "elderberry"]
    return render_template('index.html', title="Home Page", message="Welcome to Flask with Jinja2!", fruits=fruits)


if __name__ == '__main__':
    app.run(debug=True)

在“index.html”中，将自定义过滤器应用于水果列表：

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>{{ title }}</title>
</head>
<body>
    <h1>{{ message }}</h1>
    <p>This is a simple Flask application demonstrating Jinja2 templates.</p>
    
    <h2>Fruits List (Capitalized):</h2>
    <ul>
        {% for fruit in fruits|capitalize %}
        <li>{{ fruit }}</li>
        {% endfor %}
    </ul>
</body>
</html>

宏

Jinja2 中的宏类似于 Python 中的函数。它们允许您在模板中重复使用代码片段。

在“templates”文件夹中创建一个“macros.html”文件：

{% macro render_fruit_list(fruits) %}
<ul>
    {% for fruit in fruits %}
    <li>{{ fruit }}</li>
    {% endfor %}
</ul>
{% endmacro %}

更新 `index.html` 以使用宏：

{% extends "base.html" %}
{% import "macros.html" as macros %}


{% block title %}{{ title }}{% endblock %}


{% block content %}
    <h1>{{ message }}</h1>
    <p>This is a simple Flask application demonstrating Jinja2 templates.</p>
    
    <h2>Fruits List (Using Macros):</h2>
    {{ macros.render_fruit_list(fruits) }}
{% endblock %}

多级模板继承

通过添加另一级别的模板扩展来创建更复杂的模板继承示例。

在“templates”文件夹中创建“layout.html”：

{% extends "base.html" %}


{% block content %}
<div class="container">
    {% block body %}{% endblock %}
</div>
{% endblock %}

更新 `index.html` 以扩展 `layout.html`：

{% extends "layout.html" %}


{% block title %}{{ title }}{% endblock %}


{% block body %}
    <h1>{{ message }}</h1>
    <p>This is a simple Flask application demonstrating Jinja2 templates with multiple levels of inheritance.</p>
    
    <h2>Fruits List:</h2>
    <ul>
        {% for fruit in fruits %}
        <li>{{ fruit }}</li>
        {% endfor %}
    </ul>


    {% if show_greeting %}
    <p>Have a great day!</p>
    {% else %}
    <p>Goodbye!</p>
    {% endif %}
{% endblock %}

静态文件

Flask 允许您从“static”目录提供静态文件，例如 CSS、JavaScript 和图像。让我们创建一个简单的样式表并将其包含在我们的模板中。

在项目目录中创建一个名为“static”的文件夹，并添加一个名为“styles.css”的文件：

body {
    font-family: Arial, sans-serif;
}


header {
    background-color: #f8f9fa;
    padding: 20px;
    text-align: center;
}


footer {
    background-color: #f8f9fa;
    padding: 10px;
    text-align: center;
    position: fixed;
    bottom: 0;
    width: 100%;
}

更新 `base.html` 以包含样式表：

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>{% block title %}Default Title{% endblock %}</title>
    <link rel="stylesheet" href="{{ url_for('static', filename='styles.css') }}">
</head>
<body>
    <header>
        <h1>My Website</h1>
    </header>
    
    <main>
        {% block content %}{% endblock %}
    </main>
    
    <footer>
        <p>(c) 2024 My Website</p>
    </footer>
</body>
</html>

包含其他模板

有时，您可能希望将模板分解为更小的、可重复使用的部分。 Jinja2 允许您在其他模板中包含模板。

在“templates”文件夹中创建一个“header.html”文件：

<header>
    <h1>{{ header_title }}</h1>
</header>

更新 `base.html` 以包含 `header.html`：

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>{% block title %}Default Title{% endblock %}</title>
    <link rel="stylesheet" href="{{ url_for('static', filename='styles.css') }}">
</head>
<body>
    {% include 'header.html' %}
    
    <main>
        {% block content %}{% endblock %}
    </main>
    
    <footer>
        <p>(c) 2024 My Website</p>
    </footer>
</body>
</html>

更新 `app.py` 以传递参数作为头标题

@app.route('/')
def home():
    fruits = ["apple", "banana", "cherry", "date", "elderberry"]
    return render_template('index.html', title="Home Page", message="Welcome to Flask with Jinja2!", fruits=fruits, header_title="Welcome to My Website")


if __name__ == '__main__':
    app.run(debug=True)

在本博客中，我们介绍了使用 Jinja2 在 Flask 中渲染 HTML 模板的基础知识。我们创建了一个简单的 Flask 应用程序，构建了动态模板，并利用模板继承来更好地组织。 Flask 和 Jinja2 为开发动态且可维护的 Web 应用程序提供了强大的组合。

通过利用这些工具，您可以使用干净且可重用的代码创建强大且可扩展的 Web 应用程序。祝您快乐编码，关注收藏或者转发给其他小伙伴吧，谢谢！

CSS 背景重复

上一篇：软网推荐:DupScout 处理重复文件的“利器”
下一篇：如何在 HTML、CSS 和 JS 中制作明暗模式按钮

Flask 模板:使用 Jinja2 渲染 HTML

相关推荐

使用VSCode模板提高Vue开发效率（vscode开发vue3）

吃透 Vue 项目开发实践|16个方面深入前端工程化开发技巧【下】

移动前端重构实战系列:5-7章（前端移动端主要技术有哪些）

说下你的vue项目的目录结构，该怎么划分?

这么牛逼的cursor功能，赶紧用起来

8.7k star，一款超炫酷的动态可视化大屏项目

用上Vue3，你真的变了吗?（vue3 key）

20个免费音乐音效下载网站，无版权素材商业影片也可用

comfyui安装MimicMotion扩展，AI跳舞动作模仿

什么是“恒定光圈”，什么是“浮动光圈”?-摄影早自习第331