Flask Web 开发【 Chapter 3 】模板

【Chapter 3】模板

模板是一个包含响应文本的文件，其中个包含用站位变量表示的动态部分，其具体值只在请求的上下文中才能知道。

渲染是一个使用真实值替换变量，在返回最终得到的响应字符串的过程。

Jinja2 是一个强大模板引擎用来渲染模板。

3.1 Jinja2 模板引擎

3.1.1 渲染模板

默认情况下，Flask 在程序文件夹中的 templates 子文件夹中寻找模板。在下一个 hello.py 版本中，要把前面定义的模板保存在 templates 文件夹中，并分别命名为 index.html 和 user.html。

templates\index.html

    Hello World

templates\user.html

{# {{ name }} 表示一种变量，模板中的占位符 #}
Hello,{{ name }}!

hello.py：渲染模板

from flask import Flask,render_template


# 1.初始化 Flask 对象
app = Flask(__name__)
# manager = Manager(app)



# 2. 设置路由和视图函数
@app.route('/')
def index():
    # return '
Hello World!
'
    return render_template('index.html')


@app.route('/user/')
def user(name):
    # return '
Hello,%s!
' % name
    return render_template('user.html',name=name)


# 3.启动服务
if __name__ == '__main__':
    app.run(debug=True)
    # manager.run()

Flask 提供的 render_template 函数吧 Jinja2 模板引擎集成到了程序中。render_template 函数的第一个参数是模板的文件名，随后的参数都是键值对，表示模板中变量对应的真实值。在这段代码中，第二个参数收到一个名为 name 的变量。

3.1.2 变量

Jinja2 能识别所有类型的变量,甚至是一些复杂的类型,例如列表、字典和对象。

Jinja2 可以使用过滤器修改变量，过滤器名添加在变量名之后，中间使用竖线分割。

例如，下述模板以首字母大写形式显示变量 name 的值：

Hello,{{ name|capitalize }}

Jinja2 变量过滤器

safe 过滤器，默认情况下，出于安全考虑，Jinja2 会转义所有变量。

例 如，如果一个变量的值为 '

Hello

'，Jinja2 会将其渲染成 '

Hello'，浏览器能显示这个 h1 元素，但不会进行解释。很多情况下需要显示变量中存储 的 HTML 代码，这时就可使用 safe 过滤器。

3.1.3 控制结构

在模板中使用条件控制语句：

{% if user %}
    Hello,{{ user }}！
{% else %}
    Hello,Stranger!
{% endif %}

在模板中渲染一组元素,使用 for 循环实现:

    {% for comment in comments %}
        
{{ comment }}
    {% endfor %}

Jinja2 还支持宏 。宏类似 python 代码中的函数

{% macro render_comment(comment) %}
    
{{ render_comment(comment) }}
{% endmacro %}

    {% for comment in comments %}
        {{ render_comment(comment) }}
    {% endfor %}

为了重复使用宏，我们可以将其保存在单独的文件中，然后在需要使用的模板中导入：

{% import 'macros.html' as macros %}

    {% for comment in comments %}
        {{ macros.render_comment(comment) }}
    {% endfor %}

需要在多处重复使用的模板代码片段可以写入单独的文件，再包含在所有模板中，以避免重复：

{% include 'comment.html' %}

另一种重复使用代码的强大方式是模板继承，它类似于 Python 代码中的类继承。首先，创 \建一个名为 base.html 的基模板：

    
    
    {% endblock %}


    {% block body %}
    {% endblock %}

block 标签定义的元素可在衍生模板中修改。在本例中，我们定义了名为 head、title 和 body 的块。注意，title 包含在 head 中。下面这个示例是基模板的衍生模板：

{% extends "base.html" %}
{% block title %}Index{% endblock %}
{% block head %}
    {{ super() }}
    
{% endblock %}
{% block body %}
    
Hello,World
{% endblock %}

extends 指令声明这个模板衍生自 base.html。在 extends 指令之后，基模板中的 3 个块被重新定义，模板引擎会将其插入适当的位置。注意新定义的 head 块，在基模板中其内容不是空的，所以使用 super() 获取原来的内容。

3.2 使用 Flask-Bootstrap 集成 Twiitter Bootstrap

Bootstrap 是 Twitter 开发的一个开源框架，它提供的用户界面组 件可用于创建整洁且具有吸引力的网页，而且这些网页还能兼容所有现代 Web 浏览器。

要想在程序中集成 Bootstrap，显然要对模板做所有必要的改动。不过，更简单的方法是使用一个名为 Flask-Bootstrap 的 Flask 扩展，简化集成的过程。Flask-Bootstrap 使用 pip 安装：

(venv) C:\Users\76152\Desktop\PyProjects\flask\flasky>pip install flask-bootstrap

hello.py 初始化 Flask-Bootstrap

from flask_bootstrap import Bootstrap
#...
#初始化 Flask-Bootstrap
bootstrap = Bootstrap(app)

初始化 Flask-Bootstrap 之后，就可以在程序中使用一个包含所有 Bootstrap 文件的基模板。 这个模板利用 Jinja2 的模板继承机制，让程序扩展一个具有基本页面结构的基模板，其中就有用来引入 Bootstrap 的元素。

templates/user.html：使用 Flask-Bootstrap 的模板

{% extends "bootstrap/base.html" %}

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

{% block navbar %}
    

        

            

                
                    Toggle navigation
                    
                    
                    
                
                Flasky
            
            

                

                    
Home
                
            
        
    
{% endblock %}

{% block conntent %}
    

        

            
Hello,{{ name|capitalize }}!
        
    
{% endblock %}

Jinja2 中的 extends 指令从Flask-Bootstrap 中导入bootstrap/base.html，从而实现模板继承。Flask-Bootstrap 中的基模板提供了一个网页框架，引入了 Bootstrap 中的所有 CSS 和 JavaScript 文件。

基模板中定义了可在衍生模板中重定义的块。block 和 endblock 指令定义的块中的内容可 添加到基模板中。

上面这个 user.html 模板定义了3 个块，分别名为 title、navbar 和 content。这些块都是基模板提供的，可在衍生模板中重新定义。title 块的作用很明显，其中的内容会出现在渲染后的 HTML 文档头部，放在