autoescape

Source: lib/tags/autoescape.js

控制模板内的变量输出的自动转义。

参数

例子

// myvar = '<foo>';
{% autoescape true %}{{ myvar }}{% endautoescape %}
// => <foo>
{% autoescape false %}{{ myvar }}{% endautoescape %}
// => <foo>

block

Source: lib/tags/block.js

Defines a block in a template that can be overridden by a template extending this one and/or will override the current template's parent template block of the same name.

查看 模板继承 获取更多信息。

参数

例子

{% block body %}...{% endblock %}

else

Source: lib/tags/else.js

和{% if %} 标签一起使用，直到遇到 {% endif %} 或者 if 表达式返回false。

例子

{% if false %}
  statement1
{% else %}
  statement2
{% endif %}
// => statement2

elif

Source: lib/tags/elseif.js

和 {% else %}类似。

参数

例子

{% if false %}
  Tacos
{% elseif true %}
  Burritos
{% else %}
  Churros
{% endif %}
// => Burritos

extends

Source: lib/tags/extends.js

将当前模板扩展为一个父级模板。该标签必须在模板的最前面。

查看 模板继承 获取更多信息。

参数

例子

{% extends "./layout.html" %}

filter

Source: lib/tags/filter.js

为模板的一个完整的块应用过滤器。

参数

例子

{% filter uppercase %}oh hi, {{ name }}{% endfilter %}
// => OH HI, PAUL

{% filter replace(".", "!", "g") %}Hi. My name is Paul.{% endfilter %}
// => Hi! My name is Paul!

for

Source: lib/tags/for.js

遍历对象和数组。

参数

返回

loop.index: The current iteration of the loop (1-indexed)

loop.index0: The current iteration of the loop (0-indexed)

loop.revindex: The number of iterations from the end of the loop (1-indexed)

loop.revindex0: The number of iterations from the end of the loop (0-indexed)

loop.key: If the iterator is an object, this will be the key of the current item, otherwise it will be the same as the loop.index.

loop.first: True if the current object is the first in the object or array.

loop.last: True if the current object is the last in the object or array.

例子

// obj = { one: 'hi', two: 'bye' };
{% for x in obj %}
  {% if loop.first %}<ul>{% endif %}
  <li>{{ loop.index }} - {{ loop.key }}: {{ x }}</li>
  {% if loop.last %}</ul>{% endif %}
{% endfor %}
// => <ul>
//    <li>1 - one: hi</li>
//    <li>2 - two: bye</li>
//    </ul>

// arr = [1, 2, 3]
// Reverse the array, shortcut the key/index to `key`
{% for key, val in arr|reverse %}
{{ key }} -- {{ val }}
{% endfor %}
// => 0 -- 3
//    1 -- 2
//    2 -- 1

if

Source: lib/tags/if.js

用于创建条件表达式。兼容大部分JavaScript的合法比较。

可以结合 {% elseif ... %} 标签和 {% else %} 标签一起使用。

参数

例子

{% if x %}{% endif %}
{% if !x %}{% endif %}
{% if not x %}{% endif %}

{% if x and y %}{% endif %}
{% if x && y %}{% endif %}
{% if x or y %}{% endif %}
{% if x || y %}{% endif %}
{% if x || (y && z) %}{% endif %}

{% if x [operator] y %}
  Operators: ==, !=, <, <=, >, >=, ===, !==
{% endif %}

{% if x == 'five' %}
  The operands can be also be string or number literals
{% endif %}

{% if x|lower === 'tacos' %}
  You can use filters on any operand in the statement.
{% endif %}

{% if x in y %}
  If x is a value that is present in y, this will return true.
{% endif %}

import

Source: lib/tags/import.js

允许从其他文件将宏指令直接导入到当前环境。

The import tag is specifically designed for importing macros into your template with a specific context scope. This is very useful for keeping your macros from overriding template context that is being injected by your server-side page generation.

参数

例子

{% import './formmacros.html' as form %}
{{ form.input("text", "name") }}
// => <input type="text" name="name">

{% import "../shared/tags.html" as tags %}
{{ tags.stylesheet('global') }}
// => <link rel="stylesheet" href="/global.css">

include

Source: lib/tags/include.js

引入模板，该模板会在当前变量环境中被渲染。

参数

例子

// food = 'burritos';
// drink = 'lemonade';
{% include "./partial.html" %}
// => I like burritos and lemonade.

// my_obj = { food: 'tacos', drink: 'horchata' };
{% include "./partial.html" with my_obj only %}
// => I like tacos and horchata.

{% include "/this/file/does/not/exist" ignore missing %}
// => (Nothing! empty string)

macro

Source: lib/tags/macro.js

在模板中创建特定的、可重用的代码片段。

可以使用{% import ... %} 标签将代码段从一个模板导入到另一个模板。

参数

例子

{% macro input(type, name, id, label, value, error) %}
  <label for="{{ name }}">{{ label }}</label>
  <input type="{{ type }}" name="{{ name }}" id="{{ id }}" value="{{ value }}"{% if error %} class="error"{% endif %}>
{% endmacro %}

{{ input("text", "fname", "fname", "First Name", fname.value, fname.errors) }}
// => <label for="fname">First Name</label>
//    <input type="text" name="fname" id="fname" value="">

parent

Source: lib/tags/parent.js

将父级模板同名块中的内容导入到当前块中。

查看 模板继承 获取更多信息。

例子

{% extends "./foo.html" %}
{% block content %}
  My content.
  {% parent %}
{% endblock %}

raw

Source: lib/tags/raw.js

强制内容不进行自动转义。所有的swig指令都将会被忽略，内容会按照原样渲染。

例子

// foobar = '<p>'
{% raw %}{{ foobar }}{% endraw %}
// => {{ foobar }}

set

Source: lib/tags/set.js

设置变量，以便在当前环境中重用。该操作将会覆写任何已经设置并给出varname的值。

参数

例子

{% set foo = "anything!" %}
{{ foo }}
// => anything!

// index = 2;
{% set bar = 1 %}
{% set bar += index|default(3) %}
// => 3

// foods = {};
// food = 'chili';
{% set foods[food] = "con queso" %}
{{ foods.chili }}
// => con queso

// foods = { chili: 'chili con queso' }
{% set foods.chili = "guatamalan insanity pepper" %}
{{ foods.chili }}
// => guatamalan insanity pepper

spaceless

Source: lib/tags/spaceless.js

尝试移除HTML标签之间的空白符。请自行承担使用风险。

例子

{% spaceless %}
  {% for num in foo %}
  <li>{{ loop.index }}</li>
  {% endfor %}
{% endspaceless %}
// => <li>1</li><li>2</li><li>3</li>