网站首页 > 技术文章 正文
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>? 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>? 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>? 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 应用程序。祝您快乐编码，关注收藏或者转发给其他小伙伴吧，谢谢！
猜你喜欢
- 2024-11-25 [前端开发]网页设计|如何实现网页变灰效果_网站蒙灰CSS样式总汇
- 2024-11-25 Three.js开发日记3:如何在three.js模型中插入html内容?
- 2024-11-25 「测试开发全栈-HTML」(20)css的引入方式-外部样式表和总结
- 2024-11-25 web开发源代码案例3-css样式
- 2024-11-25 「测试开发全栈-HTML」(10)css字体属性之字体样式和复合属性
- 2024-11-25 「测试开发全栈-HTML」(15)css字体的文本缩进
- 2024-11-25 CSS中的z-index属性如何使用
- 2024-11-25 交互设计进阶:如何通过CSS制作引人注目的按钮
- 2024-11-25 java将html转为pdf
- 2024-11-25 「测试开发全栈-HTML」(11)css字体复合属性和小结
- 标签列表
-
- content-disposition (47)
- nth-child (56)
- math.pow (44)
- 原型和原型链 (63)
- canvas mdn (36)
- css @media (49)
- promise mdn (39)
- readasdataurl (52)
- if-modified-since (49)
- css ::after (50)
- border-image-slice (40)
- flex mdn (37)
- .join (41)
- function.apply (60)
- input type number (64)
- weakmap (62)
- js arguments (45)
- js delete方法 (61)
- blob type (44)
- math.max.apply (51)
- js (44)
- firefox 3 (47)
- cssbox-sizing (52)
- js删除 (49)
- js for continue (56)
- 最新留言
-