Python Flask 编程 | 连载 09 - Jinja2 模板特性

简介: Python Flask 编程 | 连载 09 - Jinja2 模板特性

一、模板的宏

宏,相当于函数,可以把常用功能抽取出来实现重用。HTML 中也会出现重复的代码,将重复的 HTML 代码抽取出来就成为模板的宏,模板的宏是可以写在单独的 HTML 文件中。

模板中的宏的定义需要使用到 macro 关键字。

{% marco 宏的名字%}
<!--HTML代码-->
{% endmarco %}
复制代码

在 templates 文件夹下创建 marco.html 页面,定义并使用宏。

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8"/>
    <title>Title</title>
</head>
<body>
<form action="">
    <!--定义一个宏-->
    {% macro input(name, type='text', value='')%}
        <div>
            <input class="input-control class2" type="{{ type }}" name="{{ name }}" value="{{ value }}">
        </div>
    {% endmacro %}
    {#  使用宏  #}
    <p>用户名:{{ input('username', value='admin') }}</p>
    {#  密码 password  #}
    <p>密 码:{{ input('password', type='password') }}</p>
</form>
</body>
</html>
复制代码

这里通过宏定义了一个 input 输入框,并定义了一些参数以及设置了默认值。

在 app.py 中定义一个视图函数,该视图函数返回 marco.html 页面

@app.route('/marco')
def marco():
    return render_template('macro.html')
复制代码

重新启动项目,浏览器访问 /marco

image.png

页面中显示了两个输入框,并且第一个输入框显示了设置的默认值,并且 input 框的文本类型也是通过 type 参数传递的类型。

在项目中并不会把宏的定义的代码和调用代码放在一个文件中,将宏的定义保存在 marco.html 页面中中,新建一个 form.html 并且通过 from ... import ... 来导入定义好的宏。

<form action="">
    <h2>导入并使用宏创建登录表单</h2>
    {% from 'macro.html' import input %}
    Username: {{ input('username', value='stark') }}
    Password: {{ input('password', type='password') }}
</form>
复制代码

新建一个视图函数 forms,该函数返回 forms.html。

@app.route('/forms')
def forms():
    return render_template('forms.html')
复制代码

保存代码,浏览器访问 /forms

image.png

二、模板抽象,继承与包含

模板继承

在项目中每个页面都使用了公共的导航栏和底部栏,引用了公共的 js 和 css 等静态文件,这种情况下就可以使用模板的继承,既可以通过 extends 关键字继承一个基本的页面,这个页面中包含了公共的导航栏、静态文件等,在基本页面中使用 block 关键字来定义需要重写的内容。

继承的实现大概分为三个步骤:

  1. 首先在被继承的基本页面中通过 block 关键字定义需要重写的内容
  2. 接着在新的页面中使用 extends 关键字来继承基本页面
  3. 最后就可以在新的页面中通过 block 重写新的内容
  4. 如果有的页面无须重写 block 块的内容,也可以使用 super() 关键字来复用被继承页面中的内容。

在 templates 模板下新建基本页面 base.html,将公共的 html 代码放入 base.html 中,这里通过 block 定义了 title 和 content 两个需要重写的块。

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8"/>
    {% block title %}
    <title>Title</title>
    {% endblock %}
</head>
<body>
    <div class="contain">
        <header>
            页面头部
        </header>
        <article>
            {% block content %}
                主体内容
            {% endblock %}
        </article>
        <footer>
            页面底部
        </footer>
    </div>
</body>
</html>
复制代码

新增 extends.html 并继承 base.html,只需要通过 block 关键字填充中间内容即可

{% extends 'base.html' %}
{% block title %}
<title>第一个继承实现的页面</title>
{% endblock %}
{% block content %}
    <h2>这是重写了 base.html 中的 content 部分的内容</h2>
{% endblock %}
复制代码

新增视图函数 extends。

@app.route('/extends')
def extends():
    return render_template('extends.html')
复制代码

保存代码,并在浏览器中请求 /extends

image.png

此时如果需要修改样式或者引用的文件,只需要修改 base.html 即可,比如修改 base.html 的 header,在 heade 标签中增加 css 样式。

<!--其余代码保持不变-->
<style type="text/css">
    div header {
        background-color: rebeccapurple;
    }
</style>
复制代码

保存代码后,再次访问 /extends

image.png

可以看出 extends.html 页面的头部也随之更改。

当然如果不想重写 base.html 页面中定义的 block 块,也可以使用 super() 关键字来复用 base.html 页面中的内容。

修改 extends.html 页面,复用 base.html 中 content block 块的内容,并增加新的内容。

<!--其余代码保持不变-->
{% block content %}
    <h2>复用 base.html 中的 content 部分的内容</h2>
    {{ super() }}
    <P> 主体内容 2</P>
    <P> 主体内容 3</P>
{% endblock %}
复制代码

保存代码后,再次访问 /extends

image.png

base.html 中 content block 块的内容被保留。

模板包含

include 标签

当公共的模块不是所有的页面都会使用,比如导航条,可能只有一半的页面会使用同一个导航条,这是后就可以将这个导航条单独拆出来到一个页面,相当于定义一个接口,当有页面需要使用这个导航条时,可以使用 include 关键字引入。

使用模板包含大概分为几个步骤:

  1. 首先将只有部分页面才使用的导航栏单独拆到一个页面中
  2. 接着在有需要使用导航栏的页面通过 include 关键字引入

新建一个 side.html 页面,保持只有部分页面使用的导航栏。

<p>这是一个只有部分页面才使用的导航</p>
复制代码

在 extends.html 页面中引入这个导航栏,如果页面不需要就可以不引入。

{% block content %}
    <h2>引入导航栏</h2>
    {% include 'side.html' %}
    <h2>复用 base.html 中的 content 部分的内容</h2>
    {{ super() }}
    <P> 主体内容 2</P>
    <P> 主体内容 3</P>
{% endblock %}
复制代码
保存代码后,再次访问 */extends*。
复制代码

image.png

通过模板的包含引入了在独立页面中定义的导航栏。

继承与包含的区别

继承使用关键字 extends 并使用 block 关键字定义和使用代码块,被继承的页面中包含了所有公共的内容,类似于 Java 中的类或者抽象类,而包含则是使用 include 关键字来引入代码块,相当于接口的定义,并不适用于所有页面,如果有需要可以引入。


相关文章
|
4天前
|
API 数据库 数据安全/隐私保护
Flask框架在Python面试中的应用与实战
【4月更文挑战第18天】Django REST framework (DRF) 是用于构建Web API的强力工具,尤其适合Django应用。本文深入讨论DRF面试常见问题,包括视图、序列化、路由、权限控制、分页过滤排序及错误处理。同时,强调了易错点如序列化器验证、权限认证配置、API版本管理、性能优化和响应格式统一,并提供实战代码示例。了解这些知识点有助于在Python面试中展现优秀的Web服务开发能力。
22 1
|
1天前
|
SQL 关系型数据库 MySQL
第十三章 Python数据库编程
第十三章 Python数据库编程
|
1天前
|
存储 网络协议 关系型数据库
Python从入门到精通:2.3.2数据库操作与网络编程——学习socket编程,实现简单的TCP/UDP通信
Python从入门到精通:2.3.2数据库操作与网络编程——学习socket编程,实现简单的TCP/UDP通信
|
4天前
|
SQL 中间件 API
Flask框架在Python面试中的应用与实战
【4月更文挑战第18天】**Flask是Python的轻量级Web框架,以其简洁API和强大扩展性受欢迎。本文深入探讨了面试中关于Flask的常见问题,包括路由、Jinja2模板、数据库操作、中间件和错误处理。同时,提到了易错点,如路由冲突、模板安全、SQL注入,以及请求上下文管理。通过实例代码展示了如何创建和管理数据库、使用表单以及处理请求。掌握这些知识将有助于在面试中展现Flask技能。**
12 1
Flask框架在Python面试中的应用与实战
|
5天前
|
数据安全/隐私保护 Python
Python Flask-Mail实现邮件发送
Python Flask-Mail实现邮件发送
|
7天前
|
安全 数据处理 开发者
《Python 简易速速上手小册》第7章:高级 Python 编程(2024 最新版)
《Python 简易速速上手小册》第7章:高级 Python 编程(2024 最新版)
19 1
|
7天前
|
人工智能 数据挖掘 程序员
《Python 简易速速上手小册》第1章:Python 编程入门(2024 最新版)
《Python 简易速速上手小册》第1章:Python 编程入门(2024 最新版)
35 0
|
8天前
|
API Python
Python模块化编程:面试题深度解析
【4月更文挑战第14天】了解Python模块化编程对于构建大型项目至关重要,它涉及代码组织、复用和维护。本文深入探讨了模块、包、导入机制、命名空间和作用域等基础概念,并列举了面试中常见的模块导入混乱、不适当星号导入等问题,强调了避免循环依赖、合理使用`__init__.py`以及理解模块作用域的重要性。掌握这些知识将有助于在面试中自信应对模块化编程的相关挑战。
21 0
|
8天前
|
BI 开发者 数据格式
Python代码填充数据到word模板中
【4月更文挑战第16天】
|
8天前
|
Python
Python金融应用编程:衍生品定价和套期保值的随机过程
Python金融应用编程:衍生品定价和套期保值的随机过程
24 0