iris.Django模板引擎的语法格式和语法标签使用方法，include标签传递变量方法

基础配置篇：博客模板的格式语法和后端如何传递数据到模板逻辑

前面的章节中，我们选择了使用 iris.Django 作为我们前端使用的模板引擎，因此我们这里只介绍它的相关语法。

在网络上，关于 Django 模板的标签和语法教程少之又少，并且很多都是不全面的，要么就是抄来抄去的无用文章，要么就是简单寥寥几个标签，很多时候，都不能满足使用。比如include引入模板后，如何传递变量、如何在页面声明一个临时变量等问题。为了解决网络上缺少介绍内容的问题，我特意翻读了 iris.Django 的源码，并将大部分常用到的标签，都整理出来，供参考和使用。

`iris.Django` 模板语法和使用

iris.Django 模板引擎的模板解析器是pongo2，它是一个类似于 Django 模板语法的模板引擎。Django 是一个开放源代码Python编写的Web应用框架。它的模板引擎语法相对简单，清晰，使用起来也非常方便。因此我们就使用它做为我们的博客的前端模板引擎了。

模板的嵌套引用 `include`

往往制作模板的时候，我们会将一些公共部分，比如header、footer、aside等部分，抽离出来独立存放，不需要在每一个页面都重复编写，只需要在每一个页面引入它们即可。这个时候，我们可以使用include标签。

{% include "partial/header.html" %}
{% include "partial/footer.html" %}

include可以将一个拆分出来的代码片段(fragment)嵌入到完整的文档中。使用形式是 {% include "模板文件" %} 。

如果需要引入的模板不存在的话，它会报错，如我我们不知道引入的模板是否存在，则需要增加 if_exists 判断。

{% include "partial/header.html" if_exists %}

这样如果header.html模板存在的话，则会引入，即使不存在，也不会报错，只是被忽略掉了。

默认情况下，include引入的模板，它会继承当前模板的所有变量，如果想给include引入的模板增加另外的变量，可以使用 with 来增加。如：

{% include "partial/header.html" with title="这是声明给header使用的title" %}

这样就给include引入的模板定义了title变量，当前模板的其他变量它同样也可以继续使用了。

如果需要声明多个变量给include引入的模板使用，可以连续使用 key=value 的形式增加，它们之间使用空格隔开，如：

{% include "partial/header.html" with title="这是声明给header使用的title" keywords="这是声明给header使用的keywords" %}

如果只想让include引入的模板使用指定的几个变量，而不是当前模板的所有变量，可以使用only来做限制：

{% include "partial/header.html" with title="这是声明给header使用的title" keywords="这是声明给header使用的keywords" only %}

然后在header.html中使用：

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>{{title}}</title>
    <meta name="keywords" content="{{keywords}}">
</head>

模板代码片段宏函数 `macro`

iris.Django 模板引擎可以很简便的定义一些宏函数代码片段。宏代码片段相当于一个函数，它只能调用从参数传入的变量。类似于使用include。不过macro有限定的作用域。如文章我们给文章列表的文章item使用 macro ：

定义一个宏函数
{% macro article_detail(article) %}
<li class="item">
    <a href="/article/{{article.Id}}" class="link">
        <h5 class="title">{{article.Title}}</h5>
    </a>
</li>
{% endmacro %}
使用定义的宏函数
{% for item in articles %}
    {{ article_detail(item) }}
{% endfor %}

同时宏函数还可以保存到独立的文件中，然后通过import来嵌套进来。当一个文件中包含多个宏函数，可以使用 , 将隔开连续引入多个宏函数。还可以使用as来设置别名：

保存宏函数到 article.helper

{% macro article_detail(article) %}
<li class="item">
    <a href="/article/{{article.Id}}" class="link">
        <h5 class="title">{{article.Title}}</h5>
    </a>
</li>
{% endmacro %}
{% macro article_detail2(article) %}
<li class="item">
    <a href="/article/{{article.Id}}" class="link">
        <h5 class="title">{{article.Title}}</h5>
    </a>
</li>
{% endmacro %}

在index.html中引入：

用import引入：
{% import "article.helper" article_detail, article_detail2 as article_detail_new, article_detail as new_item %}
调用：
{% for item in articles %}
    {{ article_detail(item) }}
    {{ article_detail_new(item) }}
    {{ new_item(item) }}
{% endfor %}

模板的继承 `extends`

模板的继承有点像ppt中的母版一样，我们定义好一个骨架，将一个页面都写好，大部分不用变动，需要变动的部分使用block标签包裹起来：

{% block title %}
    <title>base</title>  <!-- 如果扩写了就是扩写的，不扩写就还是用base -->
{% endblock %}

这样定义的好处是，可以在继承它的模板中，重写这个block，不重写就按母版来显示。

比如我们定义了一个base.html

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    {% block title %}
        <title>base</title>  <!-- 如果扩写了就是扩写的，不扩写就还是用base -->
    {% endblock %}
    <!-- 最新版本的 Bootstrap 核心 CSS 文件 -->
    <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/[email protected]/dist/css/bootstrap.min.css"
          integrity="sha384-BVYiiSIFeK1dGmJRAkycuHAHRg32OmUcww7on3RYdg4Va+PmSTsz/K68vbdEjh4u" crossorigin="anonymous">

    <style>
        * {
            margin: 0;
            padding: 0;
        }

        .header {
            width: 100%;
            height: 50px;
            background-color: #369;
        }
    </style>
</head>
<body>

<div class="header"></div>

<div class="container">
    <div class="row">
        <div class="col-md-3">
            {% include 'aside.html' %}
        </div>
        <div class="col-md-9">
            {% block content %}
                <h4>content</h4>
            {% endblock %}
        </div>
    </div>
</div>
</body>
</html>

然后在index.html中继承这个base.html

{% extends 'base.html' %}

{% block title %}
    <title>index</title>
{% endblock %}


{% block content %}
    <div class="col-md-9">
        <h3>index</h3>
        <p>index content</p>
    </div>

{% endblock %}

这样就是使用base.html作为母版，并在index.html 中重写了title、content两个部分。

注意：如果你在模版中使用 {% extends %} 标签，它必须是模版中的第一个标签。其他的任何情况下，模版继承都将无法工作。

在使用继承的情况下，尽可能将可能会变动的数据，都包裹在block中，因为block即使在后续的页面不重写，也不影响模板的解析，而需要重写的时候就更方便。

同样地，如果后续写到某一块，发现多个页面都需要使用到，那么这时候，就把添加到base.html中去，让它成为母版的一部分。

变量的输出

Django 模板中遍历复杂数据结构的关键是句点字符 . ，变量输出边界定义是双大括号。有一个对象是people，它有Name、Gender、Level属性，在模板中输出就是：

<ul>
  <li>网站：{{siteName}}</li>
  <li>名字：{{people.Name}}</li>
  <li>性别：{{people.Gender}}</li>
  <li>等级：{{people.Level}}</li>
</ul>

变量的过滤

同时，输出变量的时候，还支持使用过滤器，来对数据进行初级过滤，格式是：

{{obj|filter__name:param}}

比如一个变量，当它有值的时候，就输出当前值，没有值的时候，就输出默认值：

使用 default 设置默认值：

{{ userName|default:"大侠匿名"}}

default只要是空都会认为没有。我们还可以使用 default_if_none 来进行处理

{{ userName|default_if_none:"大侠匿名"}}
{{ ""|default_if_none:"n/a" }}
{{ nil|default_if_none:"n/a" }}

get_digit 可以获取变量中的数字，指定get_digit的值的话，可以获取倒数第几个数字。如：

{{ 1234567890|get_digit:0 }}
{{ 1234567890|get_digit }}
{{ 1234567890|get_digit:2 }}
{{ 1234567890|get_digit:"4" }}
{{ 1234567890|get_digit:10 }}
{{ 1234567890|get_digit:15 }}

使用 length 输出长度：

{{ value|length }}

如果 value 是 ['a', 'b', 'c', 'd']，那么输出是 4。

divisibleby 可以判断一个变量是否可以被整除，如：

{{ 21|divisibleby:3 }}
{{ 21|divisibleby:"3" }}
{{ 21|float|divisibleby:"3" }}
{{ 22|divisibleby:"3" }}
{{ 85|divisibleby:simple.number }}
{{ 84|divisibleby:simple.number }}

date 可以格式化时间：

{{ value|date:``"2006-01-02 15:04"}}

注意，这个value必须是time.Time类型，不是时间戳，如果是时间戳它会报错的。时间戳要么在控制器将它转成time.Time类型，要么就使用我们自定义的模板函数：

{{stampToDate(nowStamp, "2006-01-02 15:04")}}

truncatechars 、 truncatewords 字符串字符、单词多于指定的字符数量，那么会被截断。截断的字符串将以可翻译的省略号序列（“...”）结尾：

{{ value|truncatechars:9}}
{{ value|truncatewords:9}}

截断除了字符串截断 truncatechars ，还支持按单词截断 truncatewords

truncatechars_html 、 truncatewords_html 功能类似 truncatechars 、 truncatewords 。但是这这2个标签用来处理截取html中的字符串，它不会破坏html结构。一个是按字符截取，一个是按单词截取。截断的字符串将以可翻译的省略号序列（“...”）结尾：

{{ "This is a long test which will be cutted after some chars."|truncatechars_html:25 }}
{{ "This is a long test which will be cutted after some words."|truncatewords_html:5|safe }}

upper 、 lower 可以对单字进行大小写转换：

{{ value|upper}}
{{ value|lower}}

capfirst 可以实现句子首字母大写效果，如：

{{ "hello there!"|capfirst }}

cut 可实现删除变量中特定的字符。如：

{{ 15|cut:"5" }}
{{ "Hello world"|cut: " " }}

add 可以对要输出的内容进行追加。相当于golang中的 + ，数字则会相加后输出结果，字符串则会拼接在一起。如：

{{ 5|add:6 }}
{{ 5|add:nothing }}
{{ 5|add:"test" }}
{{ "hello "|add:"john doe" }}

addslashes 则会在指定的预定义字符前添加反斜杠。这些字符是单引号（'）、双引号（"）、反斜线（\）与NUL（NULL字符）。如：

{{ "plain' text"|addslashes }}
{{ "plain' text"|addslashes|safe }}

title 标签可以实现句子中每一个单词的首字母都变成大写，并将其余部分变成小写，用于格式化标题的输出。如：

{{ "hello there!"|title }}
{{ "HELLO THERE!"|title }}
{{ "HELLO tHERE!"|title }}

yesno yesno用于验证一个变量是否有效，它可以定义三种结果，三种结果分别用英文逗号 , 隔开，有效值、无效值、不知道类型。如果不定义，也可以留空。如：

{{ article.Status|yesno}}
{{ article.Status|yesno:"validated,not validated,unknown validation status"}}

striptags striptags 类似PHP的strip_tags函数，可以剥去字符串中的 HTML、XML 以及 PHP 的标签。该标签始终会剥离 HTML 注释。如：

{{"<title>Hello World</title>"|striptags}}
{{"<title>Hello World</title>"|striptags|safe}}

removetags 标签可以删除指定的html标签。如：

{{ "<strong><i>Hello!</i></strong>"|removetags:"i"|safe }}

pluralize 标签可以判断一个变量是否是复数。如：

customer{{ 0|pluralize }}
customer{{ 1|pluralize }}
customer{{ 2|pluralize }}
cherr{{ 0|pluralize:"y,ies" }}
cherr{{ 1|pluralize:"y,ies" }}
cherr{{ 2|pluralize:"y,ies" }}
walrus{{ 0|pluralize:"es" }}
walrus{{ 1|pluralize:"es" }}
walrus{{ simple.number|pluralize:"es" }}

random 可以随机输出集合中的一个值。如：

<p>{{ intList|random }}</p>

first 、 last 可以用于输出变量中的最开始一个字符和最后一个字符。如：

{{ "Test"|first }}
{{ "Test"|last }}

urlencode urlencode标签可以对变量进行url百分号编码。如：

{{ "https://www.kandaoni.com/?category_id=1"|urlencode }}

linebreaksbr 、 linebreaks 两个标签都可以将变量的值中的换行符变成 <br/> ，相当于PHP的 nl2br 函数。如：

{{ article.Description|linebreaksbr }}
{{ article.Description|linebreaks }}
{{ article.Description|linebreaksbr|safe }}
{{ article.Description|linebreaks|safe }}

length_is length_is可以判断变量的值的长度。只能判断字符串，数字是不行的。如：

{{ "hello"|length_is:5 }}

integer 、 float 标签可以将变量的值转换成整数、浮点数。如：

{{ "foobar"|integer }}
{{ "5.4"|float|integer }}
{{ "foobar"|float }}
{{ "5.5"|float }}
{{ "5.6"|integer|float }}

floatformat 标签可以将变量的值按浮点数格式保留指定小数点，默认只保留以为，如果末位是0，则不保留小数点。如果指定小数点后位数，则按指定位数显示。如：

{{ 34.23234|floatformat }}
{{ 34.00000|floatformat }}
{{ 34.23234|floatformat:3 }}
{{ 34.00000|floatformat:3 }}
{{ "34.23234"|floatformat }}
{{ "34.00000"|floatformat }}
{{ "34.23234"|floatformat:3 }}
{{ "34.00000"|floatformat:3 }}

join 可以将一个数组按给定的分隔符合并在一起成为字符串。如：

{{intList|join:", "}}

split 刚好和 join 相反，它可以将一个字符串按给定的分隔符将一个字符串转换成数组。如：

{{ "Hello, 99, 3.140000, good"|split:", "|join:", " }}

stringformat 可以将数字、字符串格式化成指定的格式输出。相当于 fmt.Sprintf() 。如：

{{ 0.55555|stringformat:"%.2f" }}
{{ 888|stringformat:"Test: %d" }}
{{ "你好"|stringformat:"Chinese: %s" }}

make_list 可以将字符串按字符拆分成数组，相当于 []rune("你好啊") 。如：

{{ "你好啊"|make_list|join:", " }}
{% for char in "你好啊"|make_list %}{{ char }}，{% endfor %}

center 这个标签比较有意思，可以将字符串格式化成指定长度，并将字符串放在中间，旁边使用空格填充。如果给定的长度小于字符串长度，则不会做改变。如：

'{{ "test"|center:3 }}'
'{{ "test"|center:20 }}'
{{ "test"|center:20|length }}

ljust 、 rjust 这两个标签和 center 差不多，都是给字符串填充到指定长度，但是填充方向不同。 ljust 会在右边填充空格，即让字符串靠左。 rjust 会在左边填充空格，即让字符串靠右。如：

'{{ "test"|ljust:"20" }}'
{{ "test"|ljust:"20"|length }}
'{{ "test"|rjust:"20" }}'
{{ "test"|rjust:"20"|length }}

wordcount 用来统计字符串的长度。它有2种使用方式，一种是在字符串后面，另一种是使用 filter 标签。如：

{{ ""|wordcount }}
{% filter wordcount %}{% lorem 25 w %}{% endfilter %}

wordwrap 可以将字符串按给定的长度换行。如：

{{ "hello world"|wordwrap:2 }}
<pre>{% filter wordwrap:5 %}{% lorem 26 w %}{% endfilter %}</pre>
{{ "Lorem ipsum dolor sit amet, consectetur adipisici elit."|wordwrap:2|linebreaksbr|safe }}

urlize 会自动给url、邮箱添加上a标签，并自动增加nofollow的rel。这个用来处理文章正文比较合适。urlize还支持设置true和false，用来说明显示的连接内容是否转义。如：

<p>{{ "https://www.kandaoni.com"|urlize|safe }}</p>
<p>{{ "www.kandaoni.com"|urlize|safe }}</p>
<p>{{ "kandaoni.com"|urlize|safe }}</p>
<p>{% filter urlize:true|safe %}</p>
<p>Please mail me at [email protected] or visit mit on:</p>
<p>- lorem ipsum http://www.kandaoni.com lorem ipsum</p>
<p>- lorem ipsum https://www.kandaoni.com lorem ipsum</p>
<p>- lorem ipsum https://www.kandaoni.com lorem ipsum</p>
<p>- lorem ipsum www.kandaoni.com lorem ipsum</p>
<p>- lorem ipsum www.kandaoni.com/test="test" lorem ipsum</p>
<p>{% endfilter %}</p>
<p>{% filter urlize:false|safe %}</p>
<p>- lorem ipsum www.kandaoni.com/test="test" lorem ipsum</p>
<p>{% endfilter %}</p>

urlizetrunc 的作用和 urlize 差不多，都是自动给url、邮箱添加上a标签，但是可以设置截取显示部分url内容，超过指定长度部分使用 ... 代替。如：

<p>{% filter urlizetrunc:15|safe %}</p>
<p>Please mail me at [email protected] or visit mit on:</p>
<p>- lorem ipsum http://www.kandaoni.com lorem ipsum</p>
<p>- lorem ipsum https://www.kandaoni.com lorem ipsum</p>
<p>- lorem ipsum https://www.kandaoni.com lorem ipsum</p>
<p>- lorem ipsum www.kandaoni.com lorem ipsum</p>
<p>- lorem ipsum www.kandaoni.com/test="test" lorem ipsum</p>
<p>{% endfilter %}</p>

escapejs 会将字符串按 \uxxxx 编码预设的部分字符。如：

{{ "<p>aaa</p><script>alert('xss');</script><p>bbbb</p>"|escapejs|safe }}

slice 可以对字符串、数组进行截取指定长度的数据。如：

{{ "Test"|slice:"1:" }}
{{ "Test"|slice:":3" }}
{{ "Test"|slice:"1:3"|join:"," }}
{{ intList|slice:"1:5"|join:"," }}

safe Django的模板中会对HTML标签和JS等语法标签进行自动转义，这样是为了安全，防止xss攻击。

如果不想用转义，就使用 safe 来声明要输出的内容是安全的，它就不会自动转义，也可以使用 autoescape 标签来控制开启和关闭自动转义：

用safe关闭自动转义
{{ "<script>alert('xss');</script>"|safe}}
强制开启自动转义
{% autoescape on %}
{{ "<script>alert('xss');</script>" }}
{% endautoescape %}
强制关闭自动转义，相当于使用了safe
{% autoescape off %}
{{ "<script>alert('xss');</script>" }}
{% endautoescape %}

escape escape 还可以进行声明转义。由于默认已经会自动转义，因此在此使用escape的话，会形成转义2次。因此使用 autoescape off 关闭转义后，再使用escape就等于直接输出。如：

{{ "<script>alert('xss');</script>" }}
相当于
{% autoescape off %}
{{ "<script>alert('xss');</script>"|escape }}
{% endautoescape %}

上面所有的filter 标签，都可以使用 {% filter 标签名 %}内容{% endfilter %} 来使用。比如：

{% filter lower %}This is a nice test; let's see whether it works. Foobar. {{ simple.xss }}{% endfilter %}

{% filter truncatechars:10|lower|length %}This is a nice test; let's see whether it works. Foobar. {{ simple.number }}{% endfilter %}

<p>{% filter urlize:false|safe %}</p>
<p>- lorem ipsum www.kandaoni.com/test="test" lorem ipsum</p>
<p>{% endfilter %}</p>

`for` 遍历数组、slice等对象

for 用于循环访问数组中的每个项目，从而使该项目在上下文变量中可用。例如，要显示articleList中提供的文章列表：

{% for item in articles %}
<li class="item">
    <a href="/article/{{item.Id}}" class="link">
        <h5 class="title">{{item.Title}}</h5>
    </a>
</li>
{% endfor %}

还可以输出for循环的计数，以及剩余数量，还可以使用 pluralize 判断数量是否是复数。如：

{% for item in articles %}
<li class="item">
    <a href="/article/{{item.Id}}" class="link">
        <h5 class="title">第{{ forloop.Counter }}篇，剩余{{ forloop.Revcounter}}篇，{{ forloop.Revcounter|pluralize:"多于1篇" }}：{{item.Title}}</h5>
    </a>
</li>
{% endfor %}

for 还可以使用 reversed 翻转数组， sorted 按int排序数组。如：

{% for item in articles reversed %}
<li class="item">
    <a href="/article/{{item.Id}}" class="link">
        <h5 class="title">{{item.Title}}</h5>
    </a>
</li>
{% endfor %}
{% for item in articles sorted %}
<li class="item">
    <a href="/article/{{item.Id}}" class="link">
        <h5 class="title">{{item.Title}}</h5>
    </a>
</li>
{% endfor %}
{% for item in articles reversed sorted %}
<li class="item">
    <a href="/article/{{item.Id}}" class="link">
        <h5 class="title">{{item.Title}}</h5>
    </a>
</li>
{% endfor %}

for 还支持判断是否为空数组或者nil等，使用 empty 来输出不存在的情况。如:

{% for item in articles %}
<li class="item">
    <a href="/article/{{item.Id}}" class="link">
        <h5 class="title">{{item.Title}}</h5>
    </a>
</li>
{% empty %}
<div>没有内容</div>
{% endfor %}

它等价于使用if判断，但是这样写可以更简洁：

{% if articles %}
{% for item in articles %}
<li class="item">
    <a href="/article/{{item.Id}}" class="link">
        <h5 class="title">{{item.Title}}</h5>
    </a>
</li>
{% endfor %}
{% else %}
<div>没有内容</div>
{% endif %}

cycle 标签。在for循环中，我们还可以使用 cycle 标签，来循环逐个输出定义中的变量。

每次遇到此 cycle 标签时，都会产生其参数之一。第一个参数在第一次遇到时产生，第二个参数在第二次遇到时产生，依此类推。一旦所有参数用尽，标记将循环到第一个参数并再次产生它。

此标记在循环中特别有用。如：

{% for item in articles %}
<li class="item">
    <a href="/article/{{item.Id}}" class="link">
        <h5 class="title">Title,Id 逐个出现：{% cycle item.Title item.Id %}</h5>
    </a>
</li>
{% endfor %}

或者使用 as 来定义别名，再通过别名输出：

{% for item in articles %}
<li class="item">
    <a href="/article/{{item.Id}}" class="link">
        {% cycle item.Title item.Id as cycleitem %}
        <h5 class="title">Title,Id 逐个出现：{{ cycleitem }}</h5>
    </a>
</li>
{% endfor %}

在模板中使用数学算术计算

整数和复数表达式 integers and complex expressions
{{ 10-100 }}
{{ -(10-100) }}
{{ -(-(10-100)) }}
{{ -1 * (-(-(10-100))) }}
{{ -1 * (-(-(10-100)) ^ 2) ^ 3 + 3 * (5 - 17) + 1 + 2 }}

浮点数 floats
{{ 5.5 }}
{{ 5.172841 }}
{{ 5.5 - 1.5 == 4 }}
{{ 5.5 - 1.5 == 4.0 }}

乘法、除法、整除 mul/div
{{ 2 * 5 }}
{{ 2 * 5.0 }}
{{ 2 * 0 }}
{{ 2.5 * 5.3 }}
{{ 1/2 }}
{{ 1/2.0 }}
{{ 1/0.000001 }}

逻辑表达式 logic expressions
{{ !true }}
{{ !(true || false) }}
{{ true || false }}
{{ true or false }}
{{ false or false }}
{{ false || false }}
{{ true && (true && (true && (true && (1 == 1 || false)))) }}

浮点数比较 float comparison
{{ 5.5 <= 5.5 }}
{{ 5.5 < 5.5 }}
{{ 5.5 > 5.5 }}
{{ 5.5 >= 5.5 }}

取模、取余 remainders
{{ (simple.number+7)%7 }}
{{ (simple.number+7)%7 == 0 }}
{{ (simple.number+7)%6 }}

判断一个变量是否在另一个结果集中 in/not in
{{ 5 in simple.intmap }}
{{ 2 in simple.intmap }}
{{ 7 in simple.intmap }}
{{ !(5 in simple.intmap) }}
{{ not(7 in simple.intmap) }}
{{ 1 in simple.multiple_item_list }}
{{ 4 in simple.multiple_item_list }}
{{ !(4 in simple.multiple_item_list) }}
{{ "Hello" in simple.misc_list }}
{{ "Hello2" in simple.misc_list }}
{{ 99 in simple.misc_list }}
{{ False in simple.misc_list }}

associativity for infix operators
{{ 34/3*3 }}
{{ 10 + 24 / 6 / 2 }}
{{ 6 - 4 - 2 }}

int const与uint比较 uint comparison with int const
{{ simple.uint }}
{{ simple.uint == 8 }}
{{ simple.uint == 9 }}
{{ simple.uint >= 8 }}
{{ simple.uint <= 8 }}
{{ simple.uint < 8 }}
{{ simple.uint > 8 }}

移除模板逻辑标签占用的行

这个需求很多时候会用到，比如在if-elseif 中或者是for循环中，它会连if-else标签部分的行的空行也输出。如果想清理这一行空行，可以在标签里面的前方或后方使用 - 来实现过滤,如：

{%- if false %}
1st choice
{%- elif false %}
2nd choice
{%- elif true %}
3rd choice
{%- endif %}
正常下
{% for item in articles %}
{{ item.Id }}
{% endfor %}
紧凑：
{% for item in articles %}
{{- item.Id }}
{% endfor %}
不带换行
{% for item in articles -%}
{{ item.Id }}
{%- endfor %}

在模板中使用struct结构体内置方法

比如在article列表中，article的结构体中，定义了内置函数 func (article *Article) GetThumb() ，那么在模板中，是可以直接调用的。如：

{% for item in articles %}
<li class="item">
    <a href="/article/{{item.Id}}" class="link">
        <img src="{{item.GetThumb()}}" alt="{{item.Title}}" />
        <h5 class="title">{{item.Title}}</h5>
    </a>
</li>
{% endfor %}

模板可以直接使用 {{item.GetThumb()}} 来调用内置的 article.GetThumb() 方法。

在模板中定义变量并赋值

iris.Django 模板引擎的模板解析器提供了可以在模板中声明变量并使用的方法 with 。通过 with 我们可以临时声明单个或多个变量，提供后续使用。多数情况下，我们会将它配合include标签使用。如：

{% with title="这是声明给header使用的title" keywords="这是声明给header使用的keywords" %} %}标题：{{title}}，关键词：{{keywords}}。{% endwith %}
{% include "partial/header.html" with title="这是声明给header使用的title" keywords="这是声明给header使用的keywords" %}

with 定义的变量需要使用 endwith 来包裹。

另外 iris.Django 还提供 set 的方式来声明变量，这个变量可以在当前模板使用。如：

{% set new_var = "hello" %}{{ new_var }}
{% block content %}{% set new_var = "world" %}{{ new_var }}{% endblock %}
{{ new_var }}{% for item in simple.misc_list %}
{% set new_var = item %}{{ new_var }}{% endfor %}
{{ new_var }}
{% set car=someUndefinedVar %}{{ car.Drive }}No Panic

在模板中输出当前时间

now 标签提供在模板中输出当前时间。now格式化时间的参数遵循golang的时间格式化规则。如果增加fake 参数，则会输出一个特定的加时间代替当前时间。如：

{% now "Mon Jan 2 15:04:05 -0700 MST 2006" fake %}
{% now "2006-01-02 15:04" %}

`lorem` 随机生成拉丁文样本数据

显示随机的“ lorem ipsum”拉丁文本。这对于在模板中提供样本数据很有用。也就是占位内容。在开发模板没有真实数据的时候，使用这个标签可以快速填充足够多的随机数据。如：

-----
{% lorem %}
-----
{% lorem 10 %}
-----
{% lorem 3 p %}
-----
{% lorem 100 w %}
-----

模板的注释

iris.Django 的注释我们使用大括号+#来实现注释： {# 注释内容 #}

单行注释使用 {# 这只能注释单行 #} ，多行注释使用 {% comment %}这里注释很多行{% endcomment %} 。

示例：

空单行注释

{# #}

单行注释

{# testing single line comment #}

用有效标签填充单行注释

{# testing single line comment {% if thing %}{% endif %} #}

用无效标签填充单行注释

{# testing single line comment {% if thing %} #}

用无效语法填充单行注释

{# testing single line comment {% if thing('') %}wow{% endif %} #}

空块注释

{% comment %}{% endcomment %}

填充文本单行块注释

{% comment %}filled block comment {% endcomment %}

空多行块注释

{% comment %}


{% endcomment %}

阻止带有其他标签的注释

{% comment %}
  {{ thing_goes_here }}
  {% if stuff %}do stuff{% endif %}
{% endcomment %}

阻止其中带有无效标签的注释

{% comment %}
  {% if thing %}
{% endcomment %}

使用无效语法阻止注释

{% comment %}
  {% thing('') %}
{% endcomment %}

注释之间的常规标签，以确保其在词法分析器中不会中断

{% if hello %}
{% endif %}
after if
{% comment %}All done{% endcomment %}

后端传递变量到模板

实际网站开发中，我们在控制器中的变量，需要使用特定的函数 ctx.ViewData("article", article) 注入到view中，才能在模板中使用这个变量，比如，我们在IndexPage()控制器中定义一个article，然后将它传递到模板中，用来输出。

我们先在index.go 中的 IndexPage() 函数中添加如下代码

func IndexPage(ctx iris.Context) {
    nowStamp := time.Now().Unix()
    ctx.ViewData("nowStamp", nowStamp)

    article := model.Article{
        Id:          1,
        Title:       "这是一篇文章",
        Keywords:    "这是关键词",
        Description: "这是描述",
        CategoryId:  1,
        Views:       1,
        Category:    model.Category{
            Title: "这是分类名称",
        },
        ArticleData: model.ArticleData{
            ArticleId: 1,
            Content: "<div>内容在此</div>",
        },
    }
    ctx.ViewData("article", article)
    ctx.View("index.html")
}

然后在index.html模板中输出：

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Hello World</title>
</head>
<body>
Hello World!<br>
{{stampToDate(nowStamp, "2006-01-02 15:04:05")}}<br>
<div>文章标题：{{article.Title}}</div>
<div>文章分类：{{article.Category.Title}}</div>
<div>文章Id：{{article.Id}}</div>
<div>发布时间：{{stampToDate(article.CreatedTime)}}</div>
<div>文章关键词：{{article.Keywords}}</div>
<div>文章描述：{{article.Description}}</div>
<div>文章内容：{{article.ArticleData.Content|safe}}</div>
</body>
</html>

这样，就模板就获得了article变量，然后通过模板语法，将article的成员都输出了。

完整的项目示例代码托管在GitHub上，需要查看完整的项目代码可以到 github.com/fesiong/goblog 上查看，也可以直接fork一份来在上面做修改。

有疑问加站长微信联系（非本文作者）

基础配置篇：博客模板的格式语法和后端如何传递数据到模板逻辑

`iris.Django` 模板语法和使用

模板的嵌套引用 `include`

模板代码片段宏函数 `macro`

模板的继承 `extends`

变量的输出

变量的过滤

`for` 遍历数组、slice等对象

在模板中使用数学算术计算

移除模板逻辑标签占用的行

在模板中使用struct结构体内置方法

在模板中定义变量并赋值

在模板中输出当前时间

`lorem` 随机生成拉丁文样本数据

模板的注释

后端传递变量到模板

Recommend

模板引擎 Jinja2 语法介绍

简化版的 vue 页面模板语法

Jinja2 和 JavaScript 模板引擎语法冲突处理

Flask模板引擎：Jinja2语法介绍

Vue起步（模板语法、循环语句）

Vim 的 Tornado 模板语法高亮

Django ORM中原生JSONField的使用方法

Blazor和Vue对比学习（基础1.2）：模板语法和Razor语法 - functionMC

jQuery-tmpl 模板引擎使用方法说明

element上传图片组件使用方法|图片回显|格式转换base64 - 朝颜浅语

About Joyk

iris.Django模板引擎的语法格式和语法标签使用方法，include标签传递变量方法

基础配置篇：博客模板的格式语法和后端如何传递数据到模板逻辑

iris.Django 模板语法和使用

模板的嵌套引用 include

模板代码片段宏函数 macro

模板的继承 extends

变量的输出

变量的过滤

for 遍历数组、slice等对象

在模板中使用数学算术计算

移除模板逻辑标签占用的行

在模板中使用struct结构体内置方法

在模板中定义变量并赋值

在模板中输出当前时间

lorem 随机生成拉丁文样本数据

模板的注释

后端传递变量到模板

Recommend

About Joyk

`iris.Django` 模板语法和使用

模板的嵌套引用 `include`

模板代码片段宏函数 `macro`

模板的继承 `extends`

`for` 遍历数组、slice等对象

`lorem` 随机生成拉丁文样本数据