Flask开发系列之模板

本文对《FlaskWeb开发：基于python的Web应用开发实战》模板一节做的总结。

Jinja2模板引擎

模板

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

Jinja2模板引擎

官网地址

Jinja2是纯python编写的模板引擎，它和Django类似提供non-XML语法，除此之外还支持内联表达式和一个可选的沙箱环境。Jinja2遵守BSD开源协议。

Flask渲染模板使用的是Jinja2模板引擎，所以需要安装Jinja2，pip install Jinja2。

渲染模板

from flask import Flask,render_template

app = Flask(__name__)

@app.route('/')

def index():

    return render_template('index.html')

@app.route('/user/<name>', methods=['GET'])

def reponse(name):

    print(name)

    return render_template('user.html', name=name)

if __name__ == '__main__':

    app.run(debug=True)

    # Flask提供的render_template函数把Jinja2模板引擎集成到了程序中。

    # render_template函数的第一个参数是模板的文件名。

    # 随后的参数都是键值对，表示模板中变量对应的真实值。

变量

模板中使用的{{ 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>

Jinja2变量过滤器

过滤器名添加在变量之后，中间使用竖线分隔。

hello, {{ name|capitalize }}

完整过滤器列表

常用过滤器：

过滤器名	说明
safe	渲染值时不转义
capitalize	把值得首字母转换成大写，其他字母转换成小写
lower	把值转换成小写形式
upper	把值转换成大写形式
title	把值中每个单词的首字母都换成大写
trim	把值的首位空格去掉
striptags	渲染之前把值中所有的HTML标签都删掉

控制结构

条件控制结构

{% if user %}

    Hello,{{ user }}!

{% else %}

    Hello, Stranger!

{% endif %}

渲染一组元素

<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 'macro.html' as macros %}

<ul>

    {% for comment in comments%}

        {{ macros.render_comment(comment)}}

    {% endfor%}

</ul>

复用代码片段

{% include 'common.html' %}

模板继承

- 建一个名为base.html的基模板

<html>

<head>

    {% block head %}

    <title>{% block title %}{% endblock %} - My Application</title>

    {% endblock %}

</head>

<body>

    {% block body %}

    {% endblock %}

</body>

</html>

- 衍生模板中修改block标签定义的元素

{% extends "base.html" %} #定义基模板

{% block title%}Index{% endblock %} #修改title块内容

{% block head %} #修改head块内容

    {{ super() }} #原来head中有内容，用super()获取原来的内容

    <style>

    </style>

{% endblock %}

{% block body %} #修改body块内容

<h1>Hello, World!</h1>

{% endblock %}

使用Flask-Bootstrap集成Twitter Bootstrap

Bootstrap（http://getbootstrap.com/）是 Twitter 开发的一个开源框架，它提供的用户界面组

件可用于创建整洁且具有吸引力的网页，而且这些网页还能兼容所有现代 Web 浏览器。

Bootstrap 是客户端框架，因此不会直接涉及服务器。服务器需要做的只是提供引用了

Bootstrap 层 叠 样 式 表（CSS） 和 JavaScript 文 件 的 HTML 响 应， 并 在 HTML、CSS 和

JavaScript 代码中实例化所需组件。这些操作最理想的执行场所就是模板。

要想在程序中集成 Bootstrap，显然要对模板做所有必要的改动。不过，更简单的方法是

使用一个名为 Flask-Bootstrap 的 Flask 扩展，简化集成的过程。Flask-Bootstrap 使用 pip

安装：

(venv) $ pip install flask-bootstrap

Flask 扩展一般都在创建程序实例时初始化

1. 下载flask-bootstrap

1	`pip install flask-bootstrap`

2. 找到base.html文件

将site-packages\flask_bootstrap\templates文件夹下的bootstrap目录copy到你的项目\templates目录下，确保bootstrap目录下包含base.html文件，因为我们后面要用到。

3.Flask-Bootstrap 的初始化

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

4.使用Flask-Bootstrap的模板

初始化 Flask-Bootstrap 之后，就可以在程序中使用一个包含所有 Bootstrap 文件的基模板。

这个模板利用 Jinja2 的模板继承机制，让程序扩展一个具有基本页面结构的基模板，其中

就有用来引入 Bootstrap 的元素。

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

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

{% block navbar %}

<div class="navbar navbar-inverse" role="navigation">

    <div class='container'>

        <div class="navbar-header">

            <button type="button" class="navbar-toggle"

            data-toggle="collapse" data-target=".navbar-collapse">

            <span class="sr-only">Toggle navigation</span>

            <span class='icon-bar'></span>

            <span class="icon-bar"></span>

            <span class="icon-bar"></span>

            </button>

            <a class="navbar-brand" href="/">Flasky</a>

        </div>

        <div class="navbar-collapse collapse">

            <ul class="nav navbar-nav">

                <li><a href="/"></a></li>

            </ul>

        </div>

    </div>

</div>

{% endblock %}

{% block content %}

<div class="container">

    <div class="page-header">

        <h1>Hello,{{ name }}!</h1>

    </div>

</div>

{% endblock %}

# 模板利用Bootstrap中的样式进行了修改

Jinja2 中的 extends 指令从 Flask-Bootstrap 中导入 bootstrap/base.html，从而实现模板继

承。Flask-Bootstrap 中的基模板提供了一个网页框架，引入了 Bootstrap 中的所有 CSS 和

模板 ｜ 25

JavaScript 文件。

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

添加到基模板中。

上面这个 user.html 模板定义了 3 个块，分别名为 title 、 navbar 和 content 。这些块都是

基模板提供的，可在衍生模板中重新定义。 title 块的作用很明显，其中的内容会出现在

渲染后的 HTML 文档头部，放在 <title> 标签中。 navbar 和 content 这两个块分别表示页

面中的导航条和主体内容。

在这个模板中， navbar 块使用 Bootstrap 组件定义了一个简单的导航条。 content 块中有个

<div> 容器，其中包含一个页面头部。之前版本的模板中的欢迎信息，现在就放在这个页

面头部。改动之后的程序如图 3-1 所示。

详解

Flask-Bootstrap基模板中定义的块

块名	说明
doc	整个HTML文档
html_attribs	<html>标签的属性
html	<html>标签中的内容
head	<head>标签中的内容
title	<title>标签中的内容
metas	一组标签
styles	层叠样式表定义
body_attribs	<body>标签的属性
body	<body>标签中的内容
navbar	用户定义的导航条
content	用户定义的页面内容
scripts	文档底部的JavaScript声明

自定义错误页面

利用Jinja2的模板继承机制可以让templates/base.html继承自bootstrap/base.html。

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

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

{% block navbar %}

<div class="navbar navbar-inverse" role="navigation">

    <div class="container">

        <div class="navbar-header">

            <button type="button" class="navbar-toggle" data-toggle="collapse" data-target=".navbar-collapse">

                <span class="sr-only">Toggle navigation</span>

                <span class="icon-bar"></span>

                <span class="icon-bar"></span>

                <span class="icon-bar"></span>

            </button>

            <a class="navbar-brand" href="/">Flasky</a>

        </div>

        <div class="navbar-collapse collapse">

            <ul class="nav navbar-nav">

                <li><a href="/">Home</a></li>

            </ul>

        </div>

    </div>

</div>

{% endblock %}

{% block content %}

<div class="container">

    {% block page_content %}{% endblock %}

</div>

{% endblock %}

程序现在使用的模板继承自templates/base.html不是直接继承自Flask-Bootstrap的基模板。

404错误页面：继承自templates/base.html

{% extends "base.html" %}

{% block title %}Flasky - Page Not Found{% endblock %}

{% block page_content %}

<div class="page-header">

    <h1>Not Found</h1>

</div>

{% endblock %}

user页面：继承自templates/base.html

{% extends "base.html" %}

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

{% block page_content %}

<div class="page-header">

    <h1>Hello, {{ name }}!</h1>

</div>

{% endblock %}

链接

Flask提供了url_for()辅助函数，它可以使用程序URL映射中保存的信息生成URL。

url_for函数最简单的用法：以视图函数名作为参数，返回对应的URL。url_for(‘index’)得到的结果是’/’

使用url_for生成动态地址时，将动态部分作为关键字参数传入。

url_for(‘user’,name=’john’,_external=True)

函数能将任何额外参数添加到查询字符串中。

静态文件

Web 程序不是仅由 Python 代码和模板组成。大多数程序还会使用静态文件，例如 HTML

代码中引用的图片、JavaScript 源码文件和 CSS。

例如，调用

url_for('static', filename='css/styles.css', _external=True) 得 到 的 结 果 是 http://

localhost:5000/static/css/styles.css。

默认设置下，Flask 在程序根目录中名为 static 的子目录中寻找静态文件。如果需要，可在

static 文件夹中使用子文件夹存放文件。服务器收到前面那个 URL 后，会生成一个响应，

包含文件系统中 static/css/styles.css 文件的内容。

示例展示了如何在程序的基模板中放置 favicon.ico 图标。这个图标会显示在浏览器的
地址栏中。

{% 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 %}

图标的声明会插入 head 块的末尾。注意如何使用 super() 保留基模板中定义的块的原始
内容。