loop.index 当前循环迭代的计数(从 1 开始)
loop.index0 当前循环迭代的次数(从 0 开始)
loop.revindex 到循环结束需要迭代的次数(从 1 开始)
loop.revindex0 到循环结束需要迭代的次数(从 0 开始)
loop.first 如果是第一次迭代,为 True 。
loop.last 如果是最后一次迭代,为 True 。
loop.length 序列中的元素的个数,即循环的长度;
loop.cycle 在一串序列间期取值的辅助函数。
loop.depth 当前循环在递归中的层级(从1开始)
loop.depth0 当前循环在递归中的层级(从0开始)
作用域控制with
# 限制对象的作用域,foo作为局部变量
{% with foo = 1 %}
{% set bar = 2 %}
{{ foo + bar }}
{% endwith %}
# do可以将表达式转换语句,即表示执行的意思
{% with arr = ['Sunny'] %}
{% do arr.append('Rainy') %} # 执行arr.append('Rainy')语句
{{ arr }}
{% endwith %}
算术表达式
# 其语法和python中的一模一样
{{ a + b}}
比较表达式
# 其语法和python中的一模一样
{{ a == b}}
{{ "Hello " ~ name ~ "!" }}
返回(假设 name 值为 'John' ) Hello John!
raw忽略模板的语法
# {{}} 和{%%}这种形式将失效,代表它们本身的符号
{% raw %}
{% for item in items %}
<li>{{ item }}</li>
{% endfor %}
{% endraw %}
# autoescape参数,如果为false则关闭转义,flask框架中默认为True
{% autoescape false %}
<h1>Hello {{ name }}!</h1>
{% endautoescape %}
# test.html
# 父模板
{% block head %}
{% endblock %}
# 子模板
{% extends "test.html" %}
{% block head %}
{{ super() }}
Index
{% endblock %}
想要渲染父模板中的模板需要使用{{ super() }},即如果父块中已经有语句,不是空的,如果要保留就需要使用这个
注意:继承之后,块内是无法访问块外的变量的,如果想要访问,则:
# scoped参数可以让list块内访问块外的变量
{% block list scoped %}{% endblock %}
包含include
include可以加载另一个模板在当前的位置,直接渲染;
# 直接在当前的位置
{% include 'footer.html' %}
</body>
# 当”include”的模板文件不存在时,程序会抛出异常。可以加上”ignore missing”关键字,这样如果模板不存在,就会忽略这段”{% include %}”语句。
{% include 'footer.html' ignore missing %}
# 添加多个模板
{% include ['footer.html','bottom.html','end.html'] ignore missing %}
宏简单来说就是在模板中定义并使用的函数,用来简化代码量
定义一个宏
# 使用macro定义,相当于def
{% macro input(name, type='text', value='') -%}
<input type="{{ type }}" name="{{ name }}" value="{{ value }}">
{%- endmacro %}
调用一个宏
# 通过表达式调用
<p>{{ input('username', value='user') }}</p>
<p>{{ input('password', 'password') }}</p>
# 使用call,会将里面的内容替换func函数中的caller()方法
{% call func(users) %}
<td><input name="delete" type="button" value="Delete"></td>
{% endcall %}
# 调用宏的参数,func函数中的caller(name)方法的参数name可以传递过来
{% call(name) func(users) %}
<td><input name="delete" type="button" value="Delete"></td>
{% endcall %}
宏里面自动添加了varargs和kwargs参数,可以用来接收多余的变量或键值对参数;
宏的导入:
一个宏可以被不同的模板使用,建议将其声明在一个单独的模板文件中。需要使用时导入进来即可,而导入的方法也非常类似于Python中的”import”。
{% import 'form.html' as form %}
<p>{{ form.input('username', value='user') }}</p>
http://www.bjhee.com/jinja2-statement.html
https://dormousehole.readthedocs.io/en/latest/templating.html#jinja