一、Jinja2 语法
模板标签
for循环表达式
在页面中展示列表或者字典数据时常常会用到 for循环，将列表中的每个数据迭代并进行展示，模板中 for 循环 的写法如下：
{% for key, value in data.items() %} {{ key }}: {{ value }} {% else %} {# 展示字典为空的提示 {% endfor %} 复制代码
修改 tag 视图函数，增加一个含有字典数据的变量。
@app.route('/tag') def tag(): name='stark' heros = [ {'name': 'stark', 'address': 'New York'}, {'name': 'thor', 'address': 'Asgard'}, {'name': 'strange', 'address': 'New York'}, {'name': 'peter', 'address': 'New York Queens'}, ] return render_template('tag.html', name=name, heros=heros) 复制代码
在 tag.html 的 body 标签中增加 for循环 表达式
<h2>for循环的使用</h2> <ul> {% for hero in heros %} <li>{{ hero.name }}: {{ hero.address }}</li> {% else %} <li>NO Data</li> {% endfor %} </ul> 复制代码
在浏览器中访问 /tag。
for 循环 中包含了一个 loop 对象，即指代这次迭代，loop 对象中包含了一些属性如下：
变量 |
说明 |
| loop.index | 当前循环迭代次数从1开始 |
| loop.index0 | 当前循环迭代次数从0开始 |
| loop.revindex | 循环从1开始到结束需要迭代的次数 |
| loop.revindex0 | 循环从0开始到结束需要迭代的次数 |
| loop.first | 如果是第一次迭代，该变量的值为True，否则为False |
| loop.last | 如果是最后一次迭代，该变量的值为True，否则为False |
| loop.length | 迭代序列的长度 |
| loop.cycle | 在一串序列间取值的辅助函数 |
修改 tag.html，在 head 标签中增加样式并在 body 标签中使用 loop 对象的属性。
<head> <style> .yankee { background: yellow; } .zulu { background: red; } </style> </head> <body> <h2>for循环中loop对象的使用</h2> {% for hero in heros %} <p class="{{ loop.cycle('yankee', 'zulu')}}"> 当前是第{{ loop.index }}个元素，索引为{{ loop.index0 }}，共{{ loop.length }}个元素 {% for key, value in hero.items() %} {{ key }}: {{ value }} {% endfor %} </p> {% endfor %} <body> 复制代码
再次访问 /tag。
在 Python 代码中进行 for 循环 时可以通过 continue 或者 break 关键字来跳过当前循环或者停止循环，但是在模板中是没有 continue 和 break 关键字的。
在 tag.html 中增加的 for循环，增加条件判断，当符合条件时使用 break 关键字结束循环。
<h2>for循环中使用break关键字</h2> {% for hero in heros %} <p class="{{ loop.cycle('yankee', 'zulu')}}"> 当前是第{{ loop.index }}个元素，索引为{{ loop.index0 }}，共{{ loop.length }}个元素 {% for key, value in hero.items() %} {# 符合条件时退出循环，这里的loop.index是循环字典时的loop，注意与上面循环列表的loop进行区分 #} {% if loop.index == 2 %} {% break %} {% endif %} {{ key }}: {{ value }} {% endfor %} </p> {% endfor %} 复制代码
此时页面报错出现未知的标签 break，说明在模板中是无法通过 break 来结束循环的。应在模板中添加扩展之后才可以 break 和 continue关键字。
在 app.py 中添加使用扩展的代码
app = Flask(__name__) # 为模板引擎添加扩展，支持break/continue关键字 app.jinja_env.add_extension('jinja2.ext.loopcontrols') 复制代码
再次访问 /tag。
这一次添加扩展之后，模板中 break 关键字生效。
使用标签渲染出来的 html 代码多了很多空行，这是会占用带宽的，去除这些空行有利于提升性能。
在 % 前后添加 - 可以删除空行。
<h2>for循环中使用break关键字</h2> {% for hero in heros -%} <p class="{{ loop.cycle('yankee', 'zulu')}}"> 当前是第{{ loop.index }}个元素，索引为{{ loop.index0 }}，共{{ loop.length }}个元素 {%- for key, value in hero.items() -%} {%- if loop.index == 2 -%} {% break %} {%- endif -%} {{ key }}: {{ value }} {%- endfor -%} </p> {% endfor %} 复制代码
再次查看页面的源代码，空格已被删除。
模板中的赋值
在模板中可以通过 set 关键字在 {%%} 中定义一个变量并进行赋值操作，set 关键字常与 with 关键字搭配使用，通过 with 关键字定义代码块，使得 set 关键字定义的变量只能在 with 指定的代码块使用。
{% with %} {% set classname='zulu' %} {{ classname }} {% endwith %} 复制代码
在 tag.html 中增加如下内容：
<h2>set，with关键字的使用</h2> {% with %} {% set classname='zulu' %} {# 在with代码块中定义了classname的值为zulu，背景色会变成红色 #} <p class="{{ classname }}">使用classname变量的p标签</p> {% endwith %} {# 在with代码块外，classname没有值 #} <p class="{{ classname }}">使用classname变量的p标签</p> 复制代码
在浏览器中访问 /tag。
模板标签特殊字符的转义
模板中的 {{}} 和 {%%} 来进行渲染操作，那么如何在模板中显示这些特殊字符呢？
第一种方式是将这些特殊字符普通字符串处理；
<h2>模板语法中的特殊字符显示</h2> <p>第一种方式：{{ '{{ value }}, {% if value=="stark" %}' }}</p> 复制代码
当代码比较多的时候，这种方式处理起来就比较繁琐。
第二种方式是使用 raw 标签；
<h2>模板语法中的特殊字符显示</h2> <p>第一种方式：{{ '{{ value }}, {% if value=="stark" %}' }}</p> <p>第二种方式： {% raw %} {{ value }}, {% if value=="stark" %} {% endraw %} </p> 复制代码
推荐使用第二种方式。
模板的全局函数
全局函数可以在模板中直接使用，常用的全局函数有：
- range()，返回一系列连续增加的整数
- dict()，创建字典
- cycler()，用于 CSS 类名循环
- joiner()，字符串拼接
- url_for()，URL 解析，用于静态文件地址解析、链接跳转地址解析
- get_flashed_message()：会话消息，如登录成功或者更新成功的提示
在 templates 目录下新建一个 global_funcs.html，内容如下：
<!DOCTYPE html> <html lang="en"> <head> <meta charset="UTF-8"/> <title>全局函数的使用</title> </head> <body> <h2>全局函数range()函数的使用</h2> {% for i in range(7) %} <p>{{ i }}</p> {% endfor %} </body> </html> 复制代码
在 app.py 中新建一个视图函数 global_funcs，返回 global_funcs.html 页面。
@app.route('/global_funcs') def gloab_funcs(): return render_template('global_funcs.html') 复制代码
模板中的 range 函数返回了从 0~6 之间的整数。
在 global_funcs.html 中新增 cycler 函数；
<head> <meta charset="UTF-8"/> <title>全局函数的使用</title> <style> .zulu { color: red; } .yankee { color: aqua; } </style> </head> <body> <h2>全局函数cycle()函数的使用</h2> {% set class_name = cycler('zulu', 'yankee') %} {% for i in range(7) %} <p class={{ class_name.next() }}>{{ i }}</p> {% endfor %} </body> 复制代码
cycle 函数轮询 zulu 和 yankee 两个 CSS 属性，给 range 函数生成的 7 个 p 标签填了这两个 CSS 属性。
在模板中使用 url_for 进行解析静态文件地址，新建一个 static 文件夹，并在该文件夹下新增一个 CSS 文件。
body { background-color: cadetblue; } h2 { color: white; } 复制代码
在 global_funcs.html 页面中的 head 增加引用。
<head> <!--其余代码不变--> <link rel="stylesheet" href="{{ url_for('static', filename='style.css') }}"> </head> 复制代码
样式发生改变，url_for 函数可以正确解析出 CSS 的路径。如果没有生效，清除缓存即可。
url_for 还可以根据 url name 解析出 url 映射地址。
使用 url_for 首先要给 url 设置一个 url name，在 app.py 中增加代码：
@app.route('/index') def show_html(): # 其余代码保持不变 # 给url设置一个name app.add_url_rule('/index', 'index') 复制代码
修改 global_funcs.html 页面内容如下：
<body> <h2>全局函数url_for的使用</h2> <a href="{{ url_for('index') }}">INDEX</a> </body> 复制代码
访问 /global_funcs。
点击INDEX，即可跳转到 /index 页面。
