正心全栈编程-文档站

Appearance

控制语句 ​

Jinja2 是一个现代的，设计者友好的，仿照 Django 模板的 Python 模板语言。 它速度快，被广泛使用。

在使用 jinja2 的时候需要注意 jinja2 生效的位置。

回顾基础 ​

基础代码

shell
FLASK_APP=01.流程控制.py
FLASK_DEBUG=True  # 开始调试模式，自动加载更新代码
python
from flask import Flask, render_template

app = Flask(__name__)


@app.route('/')
@app.route('/hello/<name>')
def index(name):
    return render_template('01流程控制.html', name='正心')
html
<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Hello Sample</title>
</head>
<body>

<hr>

<h2> 变量 </h2>
{% if name %}
<h3>Hello {{name}}!</h3>
{% else %}
<h1>Hello World!</h1>
{% endif %}

<hr>

</body>
</html>

模板的表达式都是包含在分隔符 {{}} 内的；控制语句都是包含在分隔符 {% %} 内的；另外，模板也支持注释，都是包含在分隔符 {# #} 内，支持块注释。

表达式 ​

表达式一般有这么几种：

  • 最常用的是变量，由 Flask 渲染模板时传过来，比如上例中的 name
  • 也可以是任意一种 Python 基础类型，比如字符串 {{ "Hello" }}，用引号括起；或者数值，列表，元祖，字典，布尔值。直接显示基础类型没啥意义，一般配合其他表达式一起用
  • 运算。包括算数运算，如 {{ 2 + 3 }}；比较运算，如 {{ 2 > 1 }}；逻辑运算，如 {{ False and True }}
  • 过滤器 | 和测试器 is 。这个在后面会介绍
  • 函数调用，如 {{ current_time() }}；数组下标操作，如 {{ arr[1] }}
  • in 操作符，如 {{ 1 in [1,2,3] }}
  • 字符串连接符 ~，作用同 Python 中的 + 一样，如 {{ "Hello "~ name ~"!" }}
  • if 关键字，如 {{ 'Hi, % s' % name if name }}。这里的 if 不是条件控制语句。

表达式很像 Python 的语法很相似

html
<h2> 表达式 </h2>
<p> 字符串: {{"Hello"}}</p>
<p> 字典: {{{'id':'1', 'name':'hello'} }}</p>
<p> 加法运算: {{1 + 2}}</p>
<p> 乘法运算: {{2 > 1}}</p>
<p> 逻辑运算: {{False and True}}</p>
<p> 成员运算: {{1 in [1,2,3] }}</p>

控制语句 ​

Jinja2 的控制语句主要就是条件控制语句 if，和循环控制语句 for，语法类似于 Python。

我们先改下 Python 代码中的 "hello" 函数，让其传入一些参数。

python
@app.route('/')
@app.route('/hello/<name>')
def index(name=None):
    if not name:
        name = ' 正心 '
    return render_template(
        '01 流程控制.html',
        name=name,
        digits=[1, 2, 3, 4, 5],
        users=[{'name': 'John'},
               {'name': 'Tom', 'hidden': True},
               {'name': 'Lisa'},
               {'name': 'Bob'}]
    )

if 判断 ​

html
<h2> 流程控制 </h2>
<h3>if 判断 </h3>
{% if name and name == 'admin'  %}
    这是管理控制台
{% elif name %}
    欢迎回来 {{name}}
{% else %}
    请登录
{% endif %}

上面是一个条件控制语句的例子，注意 if 控制语句要用{% endif %} 来结束。模板中无法像代码中一样靠缩进来判断代码块的结束。

for 循环 ​

再来看个循环的例子

html
<h3>for 循环 </h3>
{% for digit in '12345' %}
    <li>{{digit}}</li>
{% endfor %}

现在，可以看到数字 ”12345” 被一起显示出来了。我们再来看个复杂的循环例子：

html
<dl>
    {% for user in users if not user.hidden %}
        {% if loop.first %}
            <div> 用户列表:</div>
        {% endif %}
        <div class="{{ loop.cycle('odd', 'even') }}">
            <dd> 用户 {{loop.index}} : {{user.name}}</dd>
        </div>
        {% if loop.last %}
            <dd> 总用户数: {{loop.length}}</dd>
        {% endif %}
    {% else %}
        <li> 没有找到用户</li>
    {% endfor %}
</dl>

这里有三个知识点。首先 for 循环支持else语句，当待遍历的列表 ”users” 为空或者为 None 时，就进入else 语句。

其次，在 for 语句后使用 if 关键字，可以对循环中的项作过滤。本例中，所有 hidden 属性为 True 的 ”user” 都会被过滤掉。

另外，for 循环中可以访问 Jinja2 的循环内置变量。本例中，在第一项前显示标题，最后一项后显示总数，每一项显示序号。另外，奇偶项的 HTML div 元素会有不同的 class。如果加入下面的 CSS style，就能看到斑马线。

html
<style>
    .odd {background-color: #BDF;}
</style>

Jinja2 的循环内置变量主要有以下几个：

变量内容
loop.index循环迭代计数（从 1 开始）
loop.index0循环迭代计数（从 0 开始）
loop.revindex循环迭代倒序计数（从 len 开始，到 1 结束）
loop.revindex0循环迭代倒序计数（从 len－1 开始，到 0 结束）
loop.first是否为循环的第一个元素
loop.last是否为循环的最后一个元素
loop.length循环序列中元素的个数
loop.cycle在给定的序列中轮循，如上例在”odd” 和”even” 两个值间轮循
loop.depth当前循环在递归中的层级（从 1 开始）
loop.depth0当前循环在递归中的层级（从 0 开始）

其他常用语句 ​

忽略模板语法 ​

有时候，我们在页面上就是要显示 {{}} 这样的符号怎么办？Jinja2 提供了 raw 语句来忽略所有模板语法。

html
{% raw %}
    <ul>
        {% for item in items %}
            <li>{{item}}</li>
        {% endfor %}
    </ul>
{% endraw %}

自动转义 ​

我们将本文一开始的 Flask 代码 hello () 方法改动下：

python
def hello(name=None):
    if name is None:
        name = '<em>World</em>'
        ...

此时，访问http://localhost:5000/hello，页面上会显示Welcome World!，也就是这个 HTML 标签被自动转义了。

Flask 会对”.html”, “.htm”, “.xml”, “.xhtml” 这四种类型的模板文件开启 HTML 格式自动转义。这样也可以防止 HTML 语法注入。如果我们不想被转义怎么办？

html
{% autoescape false %}
    <h1> Hello {{name}}! </h1>
{% endautoescape %}

将 autoescape 开关设为 false 即可，反之，设为 true 即开启自动转义。使用 autoescape 开关前要启用 jinja2.ext.autoescape 扩展，在 Flask 框架中，这个扩展默认已启用。

赋值 ​

使用 set 关键字给变量赋值：

html
<h3> 赋值 </h3 >
{% set items = [1, 2, 3] %}
items: {{items}}

with 语句 ​

类似于 Python 中的 with 关键字，它可以限制 with 语句块内对象的作用域：

html
<h3> with 语句 </h3 >
{% with foo = 1 %}
    {% set bar = 2 %}
    {{foo + bar}}
{% endwith %}
{# 在 with 外面调用直接报错 #}
{# {{ foo + bar}} #}

使用with关键字前要启用jinja2.ext.with_ 扩展，在 Flask 框架中，这个扩展默认已启用。

执行表达式 ​

html
<h3> 执行表达式 </h3>
{% with arr=['Sunny'] %}
    {{arr.append('Rainy')}}
    {{arr}}
{% endwith %}

看上面这段代码，我们想执行列表的 append 操作，这时使用 {{arr.append ('Rainy') }} 页面会输出 None，换成 {% %} 来执行，程序会报错，因为这是个表达式，不是语句。那怎么办？我们可以启用 jinja2.ext.do 扩展。然后在模板中执行 do 语句即可：

html
<br>
{% with arr = ['Sunny'] %}
    {% do arr.append('Rainy') %}
    {{ arr }}
{% endwith %}