Jinja2 中国語 document_html/css_WEB-ITnose

从 Jinja 2.2 开始，你可以显式地指定在块中可用的变量，只需在块声明中添加 scoped修饰，就把块设定到作用域中:

{% for item in seq %}    <li>{% block loop_item scoped %}{{ item }}{% endblock %}</li>{% endfor %}

当覆盖一个块时，不需要提供 scoped修饰。

Changed in version 2.4.

当一个模板对象被传递到模板上下文，你也可以从那个对象继承。假设调用 代码传递 layout_template布局模板到环境，这段代码会工作:

{% extends layout_template %}

之前 layout_template变量一定是布局模板文件名的字符串才能工作。

当从模板生成 HTML 时，始终有这样的风险:变量包含影响已生成 HTML 的字符。有两种 解决方法:手动转义每个字符或默认自动转义所有的东西。

Jinja 两者都支持，使用哪个取决于应用的配置。默认的配置未开启自动转义有这样几个 原因:

• 转义所有非安全值的东西也意味着 Jijna 转义已知不包含 HTML 的值，比如数字，对 性能有巨大影响。
• 关于变量安全性的信息是易碎的。可能会发生强制标记一个值为安全或非安全的情况， 而返回值会被作为 HTML 转义两次。

如果启用了手动转义，按需转义变量就是 你的责任。要转义什么？如果你有 一个 可能包含 >、 <、 &或 "字符的变量，你必须转义 它，除非变量中的 HTML 有可信的良好格式。转义通过用管道传递到过滤器 |e来实现: {{ user.username|e }}。

当启用了自动转移，默认会转移一切，除非值被显式地标记为安全的。可以在应用中 标记，也可以在模板中使用 |safe过滤器标记。这种方法的主要问题是 Python 本 身没有被污染的值的概念，所以一个值是否安全的信息会丢失。如果这个信息丢失， 会继续转义，你最后会得到一个转义了两次的内容。

但双重转义很容易避免，只需要依赖 Jinja2 提供的工具而不使用诸如字符串模运算符 这样的 Python 内置结构。

返回模板数据（宏、 super、 self.BLOCKNAME）的函数，其返回值总是被标记 为安全的。

模板中的字符串字面量在自动转义中被也被视为是不安全的。这是因为安全的字符串是 一个对 Python 的扩展，而不是每个库都能妥善地使用它。

控制结构指的是所有的那些可以控制程序流的东西 —— 条件（比如 if/elif/ekse ）、 for 循环、以及宏和块之类的东西。控制结构在默认语法中以 {% .. %}块的形式 出现。

遍历序列中的每项。例如，要显示一个由 users`变量提供的用户列表:

<h1>Members</h1><ul>{% for user in users %}  <li>{{ user.username|e }}</li>{% endfor %}</ul>

因为模板中的变量保留它们的对象属性，可以迭代像 dict的容器:

<dl>{% for key, value in my_dict.iteritems() %}    <dt>{{ key|e }}</dt>    <dd>{{ value|e }}</dd>{% endfor %}</dl>

注意无论如何字典通常是无序的，所以你可能需要把它作为一个已排序的列表传入 到模板或使用 dictsort过滤器。

在一个 for 循环块中你可以访问这些特殊的变量:

在 for 循环中，可以使用特殊的 loop.cycle辅助函数，伴随循环在一个字符串/变 量列表中周期取值:

{% for row in rows %}    <li class="{{ loop.cycle('odd', 'even') }}">{{ row }}</li>{% endfor %}

从 Jinja 2.1 开始，一个额外的 cycle辅助函数允许循环限定外的周期取值。 更多信息请阅读。

与 Python 中不同，模板中的循环内不能 break或 continue。但你可以在迭代 中过滤序列来跳过项目。下面的例子中跳过了所有隐藏的用户:

{% for user in users if not user.hidden %}    <li>{{ user.username|e }}</li>{% endfor %}

好处是特殊的 loop可以正确地计数，从而不计入未迭代过的用户。

如果因序列是空或者过滤移除了序列中的所有项目而没有执行循环，你可以使用 else渲染一个用于替换的块:

<ul>{% for user in users %}    <li>{{ user.username|e }}</li>{% else %}    <li><em>no users found</em></li>{% endfor %}</ul>

也可以递归地使用循环。当你处理诸如站点地图之类的递归数据时很有用。要递归地 使用循环，你只需要在循环定义中加上 recursive修饰，并在你想使用递归的地 方，对可迭代量调用 loop变量。

下面的例子用递归循环实现了站点地图:

<ul class="sitemap">{%- for item in sitemap recursive %}    <li><a href="{{ item.href|e }}">{{ item.title }}</a>    {%- if item.children -%}        <ul class="submenu">{{ loop(item.children) }}</ul>    {%- endif %}</li>{%- endfor %}</ul>

Jinja 中的 if语句可比 Python 中的 if 语句。在最简单的形式中，你可以测试 一个变量是否未定义，为空或 false:

{% if users %}<ul>{% for user in users %}    <li>{{ user.username|e }}</li>{% endfor %}</ul>{% endif %}

像在 Python 中一样，用 elif和 else来构建多个分支。你也可以用更复杂的:

{% if kenny.sick %}    Kenny is sick.{% elif kenny.dead %}    You killed Kenny!  You bastard!!!{% else %}    Kenny looks okay --- so far{% endif %}

If 也可以被用作并作为。

宏类似常规编程语言中的函数。它们用于把常用行为作为可重用的函数，取代 手动重复的工作。

这里是一个宏渲染表单元素的小例子:

{% macro input(name, value='', type='text', size=20) -%}    <input type="{{ type }}" name="{{ name }}" value="{{        value|e }}" size="{{ size }}">{%- endmacro %}

在命名空间中，宏之后可以像函数一样调用:

<p>{{ input('username') }}</p><p>{{ input('password', type='password') }}</p>

如果宏在不同的模板中定义，你需要首先使用。

在宏内部，你可以访问三个特殊的变量:

宏也可以暴露某些内部细节。下面的宏对象属性是可用的:

如果一个宏的名称以下划线开始，它不是导出的且不能被导入。

在某些情况下，需要把一个宏传递到另一个宏。为此，可以使用特殊的 call块。 下面的例子展示了如何让宏利用调用功能:

{% macro render_dialog(title, class='dialog') -%}    <div class="{{ class }}">        <h2>{{ title }}</h2>        <div class="contents">            {{ caller() }}        </div>    </div>{%- endmacro %}{% call render_dialog('Hello World') %}    This is a simple dialog rendered by using a macro and    a call block.{% endcall %}

也可以向调用块传递参数。这在为循环做替换时很有用。总而言之，调用块的工作方 式几乎与宏相同，只是调用块没有名称。

这里是一个带参数的调用块的例子:

{% macro dump_users(users) -%}    <ul>    {%- for user in users %}        <li><p>{{ user.username|e }}</p>{{ caller(user) }}</li>    {%- endfor %}    </ul>{%- endmacro %}{% call(user) dump_users(list_of_user) %}    <dl>        <dl>Realname</dl>        <dd>{{ user.realname|e }}</dd>        <dl>Description</dl>        <dd>{{ user.description }}</dd>    </dl>{% endcall %}

过滤器段允许你在一块模板数据上应用常规 Jinja2 过滤器。只需要把代码用 filter节包裹起来:

{% filter upper %}    This text becomes uppercase{% endfilter %}

在代码块中，你也可以为变量赋值。在顶层的（块、宏、循环之外）赋值是可导出的，即 可以从别的模板中导入。

赋值使用 set标签，并且可以为多个变量赋值:

{% set navigation = [('index.html', 'Index'), ('about.html', 'About')] %}{% set key, value = call_something() %}

extends标签用于从另一个模板继承。你可以在一个文件中使用多次继承，但是 只会执行其中的一个。见上面的关于的节。

块用于继承，同时作为占位符和用于替换的内容。节中详细地介绍了块。

include语句用于包含一个模板，并在当前命名空间中返回那个文件的内容渲 染结果:

{% include 'header.html' %}    Body{% include 'footer.html' %}

被包含的模板默认可以访问活动的上下文中的变量。更多关于导入和包含的上下文 行为见。

从 Jinja 2.2 开始，你可以把一句 include 用 ignore missing标记，这样 如果模板不存在，Jinja 会忽略这条语句。当与 with或 without context语句联合使用时，它必须被放在上下文可见性语句 之前。这里是一些有效的例 子:

{% include "sidebar.html" ignore missing %}{% include "sidebar.html" ignore missing with context %}{% include "sidebar.html" ignore missing without context %}

New in version 2.2.

你也可以提供一个模板列表，它会在包含前被检查是否存在。第一个存在的模板会 被包含进来。如果给出了 ignore missing，且所有这些模板都不存在，会退化 至不做任何渲染，否则将会抛出一个异常。

例子:

{% include ['page_detailed.html', 'page.html'] %}{% include ['special_sidebar.html', 'sidebar.html'] ignore missing %}

Changed in version 2.4:如果传递一个模板对象到模板上下文，你可以用 include包含这个对 象。

Jinja2 支持在宏中放置经常使用的代码。这些宏可以被导入，并不同的模板中使用。这 与 Python 中的 import 语句类似。要知道的是，导入量会被缓存，并且默认下导入的 模板不能访问当前模板中的非全局变量。更多关于导入和包含的上下文行为见。

有两种方式来导入模板。你可以把整个模板导入到一个变量或从其中导入请求特定的宏 /导出量。

比如我们有一个渲染表单（名为 forms.html）的助手模块:

{% macro input(name, value='', type='text') -%}    <input type="{{ type }}" value="{{ value|e }}" name="{{ name }}">{%- endmacro %}{%- macro textarea(name, value='', rows=10, cols=40) -%}    <textarea name="{{ name }}" rows="{{ rows }}" cols="{{ cols        }}">{{ value|e }}</textarea>{%- endmacro %}

最简单灵活的方式是把整个模块导入为一个变量。这样你可以访问属性:

{% import 'forms.html' as forms %}<dl>    <dt>Username</dt>    <dd>{{ forms.input('username') }}</dd>    <dt>Password</dt>    <dd>{{ forms.input('password', type='password') }}</dd></dl><p>{{ forms.textarea('comment') }}</p>

此外你也可以从模板中导入名称到当前的命名空间:

{% from 'forms.html' import input as input_field, textarea %}<dl>    <dt>Username</dt>    <dd>{{ input_field('username') }}</dd>    <dt>Password</dt>    <dd>{{ input_field('password', type='password') }}</dd></dl><p>{{ textarea('comment') }}</p>

名称以一个或更多下划线开始的宏和变量是私有的，不能被导入。

Changed in version 2.4:如果传递一个模板对象到模板上下文，从那个对象中导入。

默认下，每个包含的模板会被传递到当前上下文，而导入的模板不会。这样做的原因 是导入量不会像包含量被缓存，因为导入量经常只作容纳宏的模块。

无论如何，这当然也可以显式地更改。通过在 import/include 声明中直接添加 with context或 without context，当前的上下文可以传递到模板，而且不会 自动禁用缓存。

这里有两个例子:

{% from 'forms.html' import input with context %}{% include 'header.html' without context %}

提示

在 Jinja 2.0 中，被传递到被包含模板的上下文不包含模板中定义的变量。 事实上，这不能工作:

{% for box in boxes %}    {% include "render_box.html" %}{% endfor %}

在 Jinja 2.0 中，被包含的模板 render_box.html 不能访问 box。从 Jinja 2.1 开始， render_box.html 可以这么做。

Jinja 中到处都允许使用基本表达式。这像常规的 Python 一样工作，即使你不用 Python 工作，你也会感受到其带来的便利。

表达式最简单的形式就是字面量。字面量表示诸如字符串和数值的 Python 对象。下面 的字面量是可用的:

一对中括号括起来的东西是一个列表。列表用于存储和迭代序列化的数据。例如 你可以容易地在 for 循环中用列表和元组创建一个链接的列表:

<ul>{% for href, caption in [('index.html', 'Index'), ('about.html', 'About'),                         ('downloads.html', 'Downloads')] %}    <li><a href="{{ href }}">{{ caption }}</a></li>{% endfor %}</ul>

提示

特殊常量 true、 false和 none实际上是小写的。因为这在过去会导致 混淆，过去 True扩展为一个被认为是 false 的未定义的变量。所有的这三个 常量也可以被写成首字母大写（ True、 False和 None）。尽管如此， 为了一致性（所有的 Jinja 标识符是小写的），你应该使用小写的版本。

Jinja 允许你用计算值。这在模板中很少用到，但是为了完整性允许其存在。支持下面的 运算符:

== 比较两个对象是否相等。 != 比较两个对象是否不等。 >如果左边大于右边，返回 true。 >=如果左边大于等于右边，返回 true。 <如果左边小于右边，返回 true。 <=如果左边小于等于右边，返回 true。

对于 if语句，在 for过滤或 if表达式中，它可以用于联合多个表达式:

提示

is和 in运算符同样支持使用中缀记法: foo is not bar和 foo not in bar而不是 not foo is bar和 not foo in bar。所有的 其它表达式需要前缀记法 not (foo and bar)。

下面的运算符非常有用，但不适用于其它的两个分类:

同样，也可以使用内联的 if表达式。这在某些情况很有用。例如你可以用来在一个 变量定义的情况下才继承一个模板，否则继承默认的布局模板:

{% extends layout_template if layout_template is defined else 'master.html' %}

一般的语法是 if else 。

else部分是可选的。如果没有显式地提供 else 块，会求值一个未定义对象:

{{ '[%s]' % page.title if page.title }}

abs ( number )

Return the absolute value of the argument.

Get an attribute of an object. foo|attr("bar")works like foo["bar"]just that always an attribute is returned and items are not looked up.

See Notes on subscriptions for more details.

A filter that batches items. It works pretty much like slicejust the other way round. It returns a list of lists with the given number of items. If you provide a second parameter this is used to fill up missing items. See this example:

<table>{%- for row in items|batch(3, ' ') %}  <tr>  {%- for column in row %}    <td>{{ column }}</td>  {%- endfor %}  </tr>{%- endfor %}</table>

Capitalize a value. The first character will be uppercase, all others lowercase.

Centers the value in a field of a given width.

If the value is undefined it will return the passed default value, otherwise the value of the variable:

{{ my_variable|default('my_variable is not defined') }}

This will output the value of my_variableif the variable was defined, otherwise 'my_variable is not defined'. If you want to use default with variables that evaluate to false you have to set the second parameter to true:

{{ ''|default('the string was empty', true) }}

Sort a dict and yield (key, value) pairs. Because python dicts are unsorted you may want to use this function to order them by either key or value:

{% for item in mydict|dictsort %}    sort the dict by key, case insensitive{% for item in mydict|dictsort(true) %}    sort the dict by key, case sensitive{% for item in mydict|dictsort(false, 'value') %}    sort the dict by key, case insensitive, sorted    normally and ordered by value.

Convert the characters &, <, >, ‘, and ” in string s to HTML-safe sequences. Use this if you need to display text that might contain such characters in HTML. Marks return value as markup string.

Format the value like a ‘human-readable’ file size (i.e. 13 kB, 4.1 MB, 102 Bytes, etc). Per default decimal prefixes are used (Mega, Giga, etc.), if the second parameter is set to Truethe binary prefixes are used (Mebi, Gibi).

Return the first item of a sequence.

Convert the value into a floating point number. If the conversion doesn’t work it will return 0.0. You can override this default using the first parameter.

Enforce HTML escaping. This will probably double escape variables.

Apply python string formatting on an object:

{{ "%s - %s"|format("Hello?", "Foo!") }}    -> Hello? - Foo!

Group a sequence of objects by a common attribute.

If you for example have a list of dicts or objects that represent persons with gender, first_nameand last_nameattributes and you want to group all users by genders you can do something like the following snippet:

<ul>{% for group in persons|groupby('gender') %}    <li>{{ group.grouper }}<ul>    {% for person in group.list %}        <li>{{ person.first_name }} {{ person.last_name }}</li>    {% endfor %}</ul></li>{% endfor %}</ul>

Additionally it’s possible to use tuple unpacking for the grouper and list:

<ul>{% for grouper, list in persons|groupby('gender') %}    ...{% endfor %}</ul>

As you can see the item we’re grouping by is stored in the grouperattribute and the listcontains all the objects that have this grouper in common.

Changed in version 2.6:It’s now possible to use dotted notation to group by the child attribute of another attribute.

Return a copy of the passed string, each line indented by 4 spaces. The first line is not indented. If you want to change the number of spaces or indent the first line too you can pass additional parameters to the filter:

{{ mytext|indent(2, true) }}    indent by two spaces and indent the first line too.

Convert the value into an integer. If the conversion doesn’t work it will return 0. You can override this default using the first parameter.

Return a string which is the concatenation of the strings in the sequence. The separator between elements is an empty string per default, you can define it with the optional parameter:

{{ [1, 2, 3]|join('|') }}    -> 1|2|3{{ [1, 2, 3]|join }}    -> 123

It is also possible to join certain attributes of an object:

{{ users|join(', ', attribute='username') }}

New in version 2.6:The attributeparameter was added.

Return the last item of a sequence.

Return the number of items of a sequence or mapping.

Convert the value into a list. If it was a string the returned list will be a list of characters.

Convert a value to lowercase.

Applies a filter on a sequence of objects or looks up an attribute. This is useful when dealing with lists of objects but you are really only interested in a certain value of it.

The basic usage is mapping on an attribute. Imagine you have a list of users but you are only interested in a list of usernames:

Users on this page: {{ users|map(attribute='username')|join(', ') }}

Alternatively you can let it invoke a filter by passing the name of the filter and the arguments afterwards. A good example would be applying a text conversion filter on a sequence:

Users on this page: {{ titles|map('lower')|join(', ') }}

New in version 2.7.

Pretty print a variable. Useful for debugging.

With Jinja 1.2 onwards you can pass it a parameter. If this parameter is truthy the output will be more verbose (this requires pretty)

Return a random item from the sequence.

Filters a sequence of objects by appying a test to either the object or the attribute and rejecting the ones with the test succeeding.

Example usage:

{{ numbers|reject("odd") }}

New in version 2.7.

Filters a sequence of objects by appying a test to either the object or the attribute and rejecting the ones with the test succeeding.

{{ users|rejectattr("is_active") }}{{ users|rejectattr("email", "none") }}

New in version 2.7.

Return a copy of the value with all occurrences of a substring replaced with a new one. The first argument is the substring that should be replaced, the second is the replacement string. If the optional third argument countis given, only the first countoccurrences are replaced:

{{ "Hello World"|replace("Hello", "Goodbye") }}    -> Goodbye World{{ "aaaaargh"|replace("a", "d'oh, ", 2) }}    -> d'oh, d'oh, aaargh

Reverse the object or return an iterator the iterates over it the other way round.

Round the number to a given precision. The first parameter specifies the precision (default is 0), the second the rounding method:

• 'common'rounds either up or down
• 'ceil'always rounds up
• 'floor'always rounds down

If you don’t specify a method 'common'is used.

{{ 42.55|round }}    -> 43.0{{ 42.55|round(1, 'floor') }}    -> 42.5

Note that even if rounded to 0 precision, a float is returned. If you need a real integer, pipe it through int:

{{ 42.55|round|int }}    -> 43

Mark the value as safe which means that in an environment with automatic escaping enabled this variable will not be escaped.

Filters a sequence of objects by appying a test to either the object or the attribute and only selecting the ones with the test succeeding.

Example usage:

{{ numbers|select("odd") }}

New in version 2.7.

Filters a sequence of objects by appying a test to either the object or the attribute and only selecting the ones with the test succeeding.

Example usage:

{{ users|selectattr("is_active") }}{{ users|selectattr("email", "none") }}

New in version 2.7.

Slice an iterator and return a list of lists containing those items. Useful if you want to create a div containing three ul tags that represent columns:

<div class="columwrapper">  {%- for column in items|slice(3) %}    <ul class="column-{{ loop.index }}">    {%- for item in column %}      <li>{{ item }}</li>    {%- endfor %}    </ul>  {%- endfor %}</div>

If you pass it a second argument it’s used to fill missing values on the last iteration.

Sort an iterable. Per default it sorts ascending, if you pass it true as first argument it will reverse the sorting.

If the iterable is made of strings the third parameter can be used to control the case sensitiveness of the comparison which is disabled by default.

{% for item in iterable|sort %}    ...{% endfor %}

It is also possible to sort by an attribute (for example to sort by the date of an object) by specifying the attributeparameter:

{% for item in iterable|sort(attribute='date') %}    ...{% endfor %}

Changed in version 2.6:The attributeparameter was added.

Make a string unicode if it isn’t already. That way a markup string is not converted back to unicode.

Strip SGML/XML tags and replace adjacent whitespace by one space.

Returns the sum of a sequence of numbers plus the value of parameter ‘start’ (which defaults to 0). When the sequence is empty it returns start.

It is also possible to sum up only certain attributes:

Total: {{ items|sum(attribute='price') }}

Changed in version 2.6:The attributeparameter was added to allow suming up over attributes. Also the startparameter was moved on to the right.

Return a titlecased version of the value. I.e. words will start with uppercase letters, all remaining characters are lowercase.

Strip leading and trailing whitespace.

Return a truncated copy of the string. The length is specified with the first parameter which defaults to 255. If the second parameter is truethe filter will cut the text at length. Otherwise it will discard the last word. If the text was in fact truncated it will append an ellipsis sign ( "..."). If you want a different ellipsis sign than "..."you can specify it using the third parameter.

{{ "foo bar"|truncate(5) }}    -> "foo ..."{{ "foo bar"|truncate(5, True) }}    -> "foo b..."

Convert a value to uppercase.

Escape strings for use in URLs (uses UTF-8 encoding). It accepts both dictionaries and regular strings as well as pairwise iterables.

New in version 2.7.

Converts URLs in plain text into clickable links.

If you pass the filter an additional integer it will shorten the urls to that number. Also a third argument exists that makes the urls “nofollow”:

{{ mytext|urlize(40, true) }}    links are shortened to 40 chars and defined with rel="nofollow"

Count the words in that string.

Return a copy of the string passed to the filter wrapped after 79characters. You can override this default using the first parameter. If you set the second parameter to falseJinja will not split words apart if they are longer than width. By default, the newlines will be the default newlines for the environment, but this can be changed using the wrapstring keyword argument.

New in version 2.7:Added support for the wrapstringparameter.

Create an SGML/XML attribute string based on the items in a dict. All values that are neither nonenor undefinedare automatically escaped:

<ul{{ {'class': 'my_list', 'missing': none,        'id': 'list-%d'|format(variable)}|xmlattr }}>...</ul>

Results in something like this:

<ul class="my_list" id="list-42">...</ul>

As you can see it automatically prepends a space in front of the item if the filter returned something unless the second parameter is false.

callable ( object )

Return whether the object is callable (i.e., some kind of function). Note that classes are callable, as are instances with a __call__() method.

Return true if the variable is defined:

{% if variable is defined %}    value of variable: {{ variable }}{% else %}    variable is not defined{% endif %}

See thefilter for a simple way to set undefined variables.

Check if a variable is divisible by a number.

Check if the value is escaped.

Return true if the variable is even.

Check if it’s possible to iterate over an object.

Return true if the variable is lowercased.

Return true if the object is a mapping (dict etc.).

New in version 2.6.

Return true if the variable is none.

Return true if the variable is a number.

Return true if the variable is odd.

Check if an object points to the same memory address than another object:

{% if foo.attribute is sameas false %}    the foo attribute really is the `False` singleton{% endif %}

Return true if the variable is a sequence. Sequences are variables that are iterable.

Return true if the object is a string.

Likebut the other way round.

Return true if the variable is uppercased.

默认下，下面的函数在全局作用域中可用:

返回一个包含整等差级数的列表。 range(i, j) 返回 [i, i+1, i+2, ...., j-1] ；起始值（！）默认为 0 。当给定了公差，它决定了增长（或减小）。 例如 range(4) 返回 [0, 1, 2, 3] 。末端的值被丢弃了。这些是一个 4 元素 数组的有效索引值。

例如重复一个模板块多次来填充一个列表是有用的。想向你有一个 7 个用户的 列表，但你想要渲染三个空项目来用 CSS 强制指定高度:

<ul>{% for user in users %}    <li>{{ user.username }}</li>{% endfor %}{% for number in range(10 - users|count) %}    <li class="empty"><span>...</span></li>{% endfor %}</ul>

在模板中生成 lorem ipsum 乱数假文。默认会生成 5 段 HTML ，每段在 20 到 100 词之间。如果 HTML 被禁用，会返回常规文本。这在测试布局时生成简单内容时很有 用。

方便的字典字面量替代品。 {'foo' : 'bar'}与 dict(foo=bar)等价。

周期计允许你在若干个值中循环，类似 loop.cycle的工作方式。不同于 loop.cycle的是，无论如何你都可以在循环外或在多重循环中使用它。

比如如果你想要显示一个文件夹和文件列表，且文件夹在上，它们在同一个列表中且 行颜色是交替的。

下面的例子展示了如何使用周期计:

{% set row_class = cycler('odd', 'even') %}<ul class="browser">{% for folder in folders %}  <li class="folder {{ row_class.next() }}">{{ folder|e }}</li>{% endfor %}{% for filename in files %}  <li class="file {{ row_class.next() }}">{{ filename|e }}</li>{% endfor %}</ul>周期计有下面的属性和方法:

重置周期计到第一个项。

返回当前项并跳转到下一个。

返回当前项。.

New in version 2.1.

一个小巧的辅助函数用于“连接”多个节。连接器接受一个字符串，每次被调用时返回 那个字符串，除了第一次调用时返回一个空字符串。你可以使用它来连接:

{% set pipe = joiner("|") %}{% if categories %} {{ pipe() }}    Categories: {{ categories|join(", ") }}{% endif %}{% if author %} {{ pipe() }}    Author: {{ author() }}{% endif %}{% if can_edit %} {{ pipe() }}    <a href="?action=edit">Edit</a>{% endif %}

New in version 2.1.

下面的几节涵盖了可能被应用启用的 Jinja2 内置的扩展。应用也可以提供进一步 的扩展，但这不会在此描述。会有独立的文档来解释那种情况下的扩展。

如果启用来 i18n 扩展，可以把模板中的部分标记为可译的。标记一个段为可译的，可 以使用 trans:

<p>{% trans %}Hello {{ user }}!{% endtrans %}</p>

要翻译一个模板表达式——比如使用模板过滤器或访问对象的属性——你需要绑定表达式到 一个名称来在翻译块中使用:

<p>{% trans user=user.username %}Hello {{ user }}!{% endtrans %}</p>

如果你需要在 trans标签中绑定一个以上的表达式，用逗号来分割（ ,）:

{% trans book_title=book.title, author=author.name %}This is {{ book_title }} by {{ author }}{% endtrans %}

在翻译块中不允许使用语句，只能使用变量标签。

为表示复数，在 trans和 endtrans之间用 pluralize标签同时指定单数和复 数形式:

{% trans count=list|length %}There is {{ count }} {{ name }} object.{% pluralize %}There are {{ count }} {{ name }} objects.{% endtrans %}

默认情况下块中的第一个变量用于决定使用单数还是复数。如果这不奏效，你可以指定 用于复数的名称作为 pluralize的参数:

{% trans ..., user_count=users|length %}...{% pluralize user_count %}...{% endtrans %}

也可以翻译表达式中的字符串。为此，有三个函数:

_ gettext: 翻译一个单数字符串 - ngettext: 翻译一个复数字符串 - _: gettext的别名

例如你可以容易地这样打印一个已翻译的字符串:

{{ _('Hello World!') }}

你可以使用 format过滤器来使用占位符:

{{ _('Hello %(user)s!')|format(user=user.username) }}

因为其它语言可能不会用同样的顺序使用词汇，要使用多个占位符，应始终用字符 串参数传给 format。

Changed in version 2.5.

如果激活了新样式的 gettext 调用（ 新样式 Gettext ），使用占位符 会更加简单:

{{ gettext('Hello World!') }}{{ gettext('Hello %(name)s!', name='World') }}{{ ngettext('%(num)d apple', '%(num)d apples', apples|count) }}

注意 ngettext函数的格式化字符串自动接受 num参数作为计数作为附加的 常规参数。

如果加载了表达式语句扩展，一个名为 do的扩展即可用。它工作几乎如同常规的变量 表达式（ {{ ... }}），只是它不打印任何东西。这可以用于修改列表:

{% do navigation.append('a string') %}

如果应用启用来 循环控制 ，则可以在循环中使用 break和 continue。到达 break时，循环终止。到达 continue时，当前处理会终止并 从下一次迭代继续。

这个循环每两项跳过一次:

{% for user in users %}    {%- if loop.index is even %}{% continue %}{% endif %}    ...{% endfor %}

同样，这个循环 10 次迭代之后会终止处理:

{% for user in users %}    {%- if loop.index >= 10 %}{% break %}{% endif %}{%- endfor %}

New in version 2.3.

如果应用启用了 With 语句 ，将允许在模板中使用 with关键 字。这使得创建一个新的内作用域。这个作用域中的变量在外部是不可见的。

With 用法简介:

{% with %}    {% set foo = 42 %}    {{ foo }}           foo is 42 here{% endwith %}foo is not visible here any longer

因为在作用域的开始设置变量很常见，你可以在 with 语句里这么做。下面的两 个例子是等价的:

{% with foo = 42 %}    {{ foo }}{% endwith %}{% with %}    {% set foo = 42 %}    {{ foo }}{% endwith %}

New in version 2.4.

如果你的应用程序设置了 自动转义扩展 ，你就可以在模版中开启或者关闭自动转义。

例子:

{% autoescape true %}自动转义在这块文本中是开启的。{% endautoescape %}{% autoescape false %}自动转义在这块文本中是关闭的。{% endautoescape %}

在 endautoescape标签之后，自动转义的行为将回到与之前相同的状态。