Flask学习笔记(二) 模板

模板是包含响应文本的文件,其中包含用占位变量表示的动态部分,其具体值只在请求的 上下文中才能知道。使用真实值替换变量,再返回最终得到的响应字符串,这一过程称为渲染。为了渲染模板,Flask 使用一个名为 Jinja2 的强大模板引擎

演示代码可切换至3a分支查看

关于<h1>标签:https://www.w3school.com.cn/tags/tag_hn.asp

模板中的变量:

使用的 {{ name }} 结构表示一个变量,这是一种特殊的占位符,告诉模板引擎这个位置的值从渲染模板时使用的数据中获取。Jinja2 能识别所有类型的变量,甚至是一些复杂的类型,例如列表、字典和对象。下面是 在模板中使用变量的一些示例:

<p>A value from a dictionary: {{ mydict['key'] }}.</p>
<p>A value from a list: {{ mylist[3] }}.</p>
<p>A value from a list, with a variable index: {{ mylist[myintvar] }}.</p>
<p>A value from an object's method: {{ myobj.somemethod() }}.</p>

变量的值可以使用过滤器修改。过滤器添加在变量名之后,二者之间以竖线分隔。例如,
下述模板把 name 变量的值变成首字母大写的形式:

Hello, {{ name|capitalize }}

下表列出了常用过滤器:

模板中的控制结构:

条件判断语句:
{% if user %}
    Hello, {{ user }}!
{% else %}
    Hello, Stranger!
{% endif %}


for循环:
<ul>
 {% for comment in comments %}
     <li>{{ comment }}</li>
 {% endfor %}
</ul>


宏(类似于函数):
{% macro render_comment(comment) %}
    <li>{{ comment }}</li>
{% endmacro %}

<ul>
    {% for comment in comments %}
        {{ render_comment(comment) }}
    {% endfor %}
</ul>


为了重复使用宏,可以把宏保存在单独的文件中,然后在需要使用的模板中导入:
{% import 'macros.html' as macros %}
<ul>
    {% for comment in comments %}
        {{ macros.render_comment(comment) }}
    {% endfor %}
</ul>


需要在多处重复使用的模板代码片段可以写入单独的文件,再引入所有模板中,以避免重复:
{% include 'common.html' %}



另一种重复使用代码的强大方式是模板继承,这类似于 Python 代码中的类继承。首先,创
建一个名为 base.html 的基模板:
<html>
<head>
    {% block head %}
    <title>{% block title %}{% endblock %} - My Application</title>
    {% endblock %}
</head>
<body>
    {% block body %}
    {% endblock %}
</body>
</html>

基模板中定义的区块可在衍生模板中覆盖。Jinja2 使用 block 和 endblock 指令在基模板中
定义内容区块。在本例中,我们定义了名为 head、title 和 body 的区块。注意,title 包
含在 head 中。
下面这个示例是基模板的衍生模板:

{% extends "base.html" %}
{% block title %}Index{% endblock %}
{% block head %}
    {{ super() }}
    <style>
    </style>
{% endblock %}
{% block body %}
<h1>Hello, World!</h1>
{% endblock %}

extends 指令声明这个模板衍生自 base.html。在 extends 指令之后,基模板中的 3 个区块
被重新定义,模板引擎会将其插入适当的位置。如果基模板和衍生模板中的同名区块中都
有内容,衍生模板中的内容将显示出来。在衍生模板的区块里可以调用 super(),引用基
模板中同名区块里的内容。上例中的 head 区块就是这么做的。




使用Flask-Bootstrap集成Bootstrap:

Bootstrap 是 Twitter 开发的一个开源 Web 框架,它提供的用户界面组件可用于创建整洁且 具有吸引力的网页,而且兼容所有现代的桌面和移动平台 Web 浏览器。

如何安装: pip install flask-bootstrap

扩展通常从 flask_ 包中导入,其中是扩展的名称。多数 Flask 扩展采用两种初始化方式中的一种。在本示例中,初始化扩展的方式是把应用实例作为参数传给构造函数。后面将介绍大型应用初始化扩展的一种高级方式 。

from flask_bootstrap import Bootstrap
# ...
bootstrap = Bootstrap(app)

初始化 Flask-Bootstrap 之后,就可以在应用中使用一个包含所有 Bootstrap 文件和一般结构的基模板。

具体效果切换至3b分支查看。

很多区块都是 Flask-Bootstrap 自用的,如果直接覆盖可能会导致一些问题。例 如,Bootstrap 的 CSS 和 JavaScript 文件在 styles 和 scripts 区块中声明。如果应用需要向 已经有内容的块中添加新内容,必须使用 Jinja2 提供的 super() 函数。例如,如果要在衍生模板中添加新的 JavaScript 文件,需要这么定义 scripts 区块:

{% block scripts %}
{{ super() }}
<script type="text/javascript" src="my-script.js"></script>
{% endblock %}

自定义错误界面:

Flask 允许应用使用模板自定义错误页面。最常见的错误代码有两个: 404,客户端请求未知页面或路由时显示;500,应用有未处理的异常时显示。用 app.errorhandler 装饰器为这两个错误提供自定义的处理函数:

@app.errorhandler(404)
def page_not_found(e):
    return render_template('404.html'), 404
@app.errorhandler(500)
def internal_server_error(e):
    return render_template('500.html'), 500

效果切3c分支查看

URL链接:

在模板中直接编写简单路由的 URL 链接不难,但对于包含可变部分的动态路由,在模板 中构建正确的 URL 就很困难了。而且,直接编写 URL 会对代码中定义的路由产生不必要 的依赖关系。如果重新定义路由,模板中的链接可能会失效。 为了避免这些问题,Flask 提供了 url_for() 辅助函数,它使用应用的 URL 映射中保存的 信息生成 URL

url_for也可以参考这里:https://www.cnblogs.com/liuxiaowei/p/9039622.html

url_for() 函数最简单的用法是以视图函数名(或者 app.add_url_route() 定义路由时 使用的端点名)作为参数,返回对应的 URL。例如,在当前版本的 hello.py 应用中调用url_for('index') 得到的结果是 /,即应用的根 URL。调用 url_for('index', _external=True) 返回的则是绝对地址,在这个示例中是 http://localhost:5000/

使用 url_for() 生成动态 URL 时,将动态部分作为关键字参数传入。例如,url_for('user', name='john', _external=True) 的返回结果是 http://localhost:5000/user/john

传给 url_for() 的关键字参数不仅限于动态路由中的参数,非动态的参数也会添加到查询 字符串中。例如,url_for('user', name='john', page=2, version=1) 的返回结果是 /user/ john?page=2&version=1

此外, url_for()也可以用在模板中

静态文件:

Web 应用不是仅由 Python 代码和模板组成。多数应用还会使用静态文件,例如模板中 HTML 代码引用的图像、JavaScript 源码文件和 CSS

你可能还记得,在笔记(一)中审查 hello.py 应用的 URL 映射时,其中有一个 static 路由。 这是 Flask 为了支持静态文件而自动添加的,这个特殊路由的 URL 是 /static/。 例如,调用 url_for('static', filename='css/styles.css', _external=True) 得到的结果 是 http://localhost:5000/static/css/styles.css 

默认设置下,Flask 在应用根目录中名为 static 的子目录中寻找静态文件。如果需要,可在 static 文件夹中使用子文件夹存放文件。服务器收到映射到 static 路由上的 URL后,生成的响应包含文件系统中对应文件里的内容。添加图标的例子:

templates/base.html:定义收藏夹图标

{% block head %}
{{ super() }}
<link rel="shortcut icon" href="{{ url_for('static', filename='favicon.ico') }}"
 type="image/x-icon">
<link rel="icon" href="{{ url_for('static', filename='favicon.ico') }}"
 type="image/x-icon">
{% endblock %}

更详细见3d分支

使用Flask-Moment本地化日期和时间:

Flask-Moment 是一个 Flask 扩展,能简化把 Moment.js 集成到 Jinja2 模板中 的过程。Flask-Moment 使用 pip 安装:

pip install flask-moment

值得一提的是初始化,导入多个库的时候初始化样子:

除了 Moment.js,Flask-Moment 还依赖 jQuery.js。因此,要在 HTML 文档的某个地方引入 这两个库,可以直接引入,这样可以选择使用哪个版本,也可以使用扩展提供的辅助函 数,从内容分发网络(CDN,content delivery network)中引入通过测试的版本。Bootstrap 已经引入了 jQuery.js,因此只需引入 Moment.js 即可。示例 3-12 展示了如何在基模板的 scripts 块中引入这个库,同时还保留基模板中定义的原始内容。注意,这个区块在 FlaskBootstrap 的基模板中已经预定义,因此放在 templates/base.html 的任何位置都行

示例 3-12 templates/base.html:引入 Moment.js 库
{% block scripts %}
{{ super() }}
{{ moment.include_moment() }}
{% endblock %}

详细使用见3e分支及原书

发布了161 篇原创文章 · 获赞 71 · 访问量 11万+

猜你喜欢

转载自blog.csdn.net/yxpandjay/article/details/99949837