Flask：Jinjia模板
Jinja2是Python下一个被广泛应用的模版引擎，他的设计思想来源于Django的模板引擎，并扩展了其语法和一系列强大的功能。
一、变量
1.1 手动传入的变量：
- 基本类型：{{ var }}
- 字典类型：{{ mydic [ 'key' ] }} 或 {{ mydic.key }}
- 列表类型：{{ mylist [ myindex ] }}
- 对象类型：{{ myobj. somemethod() }}
1.2 全局变量：
可用的全局变量：config、request、session、g、通过上下文管理器注册到全局变量...
1.3 过滤器：
| 过滤器名 | 说明 |
|---|---|
safe |
渲染值时不转义 |
capitalize |
把值的首字母转换成大写，其他字母转换成小写 |
lower |
把值转换成小写形式 |
upper |
把值转换成大写形式 |
title |
把值中每个单词的首字母都转换成大写 |
trim |
把值的首尾空格删掉 |
striptags |
渲染之前把值中所有的 HTML 标签都删掉 |
-
使用语法：{{ var|safe }}
-
过滤器可以嵌套使用
-
可以自定义过滤器
二、控制结构
2.1 条件判断
{% if user="张三" %}
Hello, {{ user }}!
{% elif user="李四"%}
Hello, 李四!
{% else %}
Hello, Stranger!
{% endif %}
判断条件兼容python语法的条件判断，另外还有Jinjia模板内置判断条件：
| 判断条件 | 说明 | 实例 |
|---|---|---|
| defined/undefined | 环境中是否有此变量的定义 | if var is defined |
| none | 变量是否为none | if var is none |
| number/string | 数字、字符判断 | ... |
| even/odd | 奇偶判断 | ... |
| upper/lower | 大小写判断 | ... |
2.2 循环
Jinjia模板的循环语法如下，但原生不支持break和continue语句，可通过扩展实现app.jinjia_env.add_extension('jinjia2.ext.loopcontrols')
<ul>
{% for comment in comments %}
<li>{{ comment }}</li>
{% else %}
<li>如果循环体为空则显示这里（可选）</li>
{% endfor %}
</ul>
Jinjia模板中循环体内的内置函数：
| 变量 | 描述 |
|---|---|
| loop.index | 当前循环迭代的次数（从1开始） |
| loop.index0 | 当前循环迭代的次数（从0开始） |
| loop.revindex | 到循环结束需要迭代的次数（从1开始） |
| loop.revindex0 | 到循环结束需要迭代的次数（从0开始） |
| loop.first | 若是第一次迭代，则返回True |
| loop.last | 若是最后一次迭代，则返回True |
| loop.length | 当前循环的总长度 |
| loop.cycle(a,b,c) | 循环的从指定序列中取值 |
三、模板重用
3.1 模板宏
定义单独的宏文件（macro.html）
{% macro render_comment(comment) %}
<li>{{ comment }}</li>
{% endmacro %}
导入使用：
{% import 'macros.html' as macros %}
<ul>
{% for comment in comments %}
{{ macros.render_comment(comment) }}
{% endfor %}
</ul>
3.2 模板包含
需要在多处重复使用的模板代码片段可以写入单独的文件，再引入所有模板中，以避免重复。
{% include 'common.html' %}
{% include 'common.html' ignore missing %} #如果模板不存在，不会报错
{% include 'common.html' with/without context %} #是否携带当前页面的上下文
3.3 模板继承
Jinja2 使用 block 和 endblock 指令在基模板中定义内容区块。
- 语法：
- 同名区块直接覆盖
- 同名区块可使用super()扩展
{% extends "base.html" %}
{% block title %}Index{% endblock %}
{% block head %}
{{ super() }}
<style>
</style>
{% endblock %}
{% block body %}
<h1>Hello, World!</h1>
{% endblock %}
四、模板中的全局函数
| 函数 | 说明 |
|---|---|
| url_for() | 构建URL |
| get_flashed_messages() | 获取闪现消息 |
| range() | 同python中的range函数 |
| dict() | 同python中的dict函数 |
| cycler(* items) | 常用于CSS类名的循环 |
五、其他
5.1 模板注释：
模板注释的语法：{{# ... #}}，模板注释不会出现在HTML文档中，HTML注释会。
5.2 除HTML文档中多余的空白：
在模板标签的开始或结束添加一个 -
{%- for comment in comments %}
<li>{{ comment }}</li>
{% endfor -%}
5.3 使用变量：
设置变量：{{% set a,b=(1,2) %}}
使用with实现变量的块级作用域：
{{% with %}}
{{% set a,b=(1,2) %}}
...只在区块内有效
{{% endwith %}}
