Django内置template标签

html过滤{% autoescape on|off %} {{body}} {% endautoescape %}

注释{% comment %} {% endcomment %}

csrf攻击 {% csrf_token %}

循环选择 {% cycle %}    <tr class='{% cycle 'row1' 'row2' %}>

使用当前循环选择

<tr>
    <td class="{% cycle 'row1' 'row2' as rowcolors %}">...</td>
    <td class="{{ rowcolors }}">...</td>
</tr>
<tr>
    <td class="{% cycle rowcolors %}">...</td>
    <td class="{{ rowcolors }}">...</td>
</tr>

注意到变量的值是没有自动转义的，所以要加上显式转义：

{% for o in some_list %}
    <tr class="{% filter force_escape %}{% cycle rowvalue1 rowvalue2 %}{% endfilter %}">
        ...
    </tr>
{% endfor %}

如果你只是想声明这个循环，而不是输出循环的值，那么在标签的最后增加关键字silent。例：

{% for obj in some_list %}
    {% cycle 'row1' 'row2' as rowcolors silent %}
    <tr class="{{ rowcolors }}">{% include "subtemplate.html " %}</tr>
{% endfor %}

一旦你在cycle定义中使用了关键字silent，随后的cycle标签也会自动使用silent。下面的例子什么也不会输出，即使第二次cycle没有指定silent

{% cycle 'row1' 'row2' as rowcolors silent %}
{% cycle rowcolors %}

---

new in Django1.6

{% load cycle from future %}

此时可以使用autoescape off

{% for o in some_list %}
    <tr class="{% autoescape off %}{% cycle rowvalue1 rowvalue2 %}{% endautoescape %}">
        ...
    </tr>
{% endfor %}

---

输出地一个不是false的变量

{% firstof var1 var2 var3 %}

等价于

{% if var1 %}
    {{ var1|safe }}
{% elif var2 %}
    {{ var2|safe }}
{% elif var3 %}
    {{ var3|safe }}
{% endif %}

可以加个默认值

{% firstof var1 var2 var3 "fallback value" %}

---

{% include "name_snippet.html" with person="Jane" greeting="Hello" %}

加入新页面,传入新变量.

---

重新分组

假设传入的参数如下:

cities = [
    {'name': 'Mumbai', 'population': '19,000,000', 'country': 'India'},
    {'name': 'Calcutta', 'population': '15,000,000', 'country': 'India'},
    {'name': 'New York', 'population': '20,000,000', 'country': 'USA'},
    {'name': 'Chicago', 'population': '7,000,000', 'country': 'USA'},
    {'name': 'Tokyo', 'population': '33,000,000', 'country': 'Japan'},
]

我们想按照国家来划分展示:

• India
  • Mumbai: 19,000,000
  • Calcutta: 15,000,000
• USA
  • New York: 20,000,000
  • Chicago: 7,000,000
• Japan
  • Tokyo: 33,000,000

我们可以使用{% regroup %}

{% regroup cities by country as country_list %}

<ul>
{% for country in country_list %}
    <li>{{ country.grouper }}
    <ul>
        {% for item in country.list %}
          <li>{{ item.name }}: {{ item.population }}</li>
        {% endfor %}
    </ul>
    </li>
{% endfor %}
</ul>

但是相同country必须挨在一起排列

cities = [
    {'name': 'Mumbai', 'population': '19,000,000', 'country': 'India'},
    {'name': 'New York', 'population': '20,000,000', 'country': 'USA'},
    {'name': 'Calcutta', 'population': '15,000,000', 'country': 'India'},
    {'name': 'Chicago', 'population': '7,000,000', 'country': 'USA'},
    {'name': 'Tokyo', 'population': '33,000,000', 'country': 'Japan'},
]

否则会输出如下:

• India
  • Mumbai: 19,000,000
• USA
  • New York: 20,000,000
• India
  • Calcutta: 15,000,000
• USA
  • Chicago: 7,000,000
• Japan
  • Tokyo: 33,000,000

解决办法可以使用

{% regroup cities|dictsort:"country" by country as country_list %}

并且我们也可以使用country的属性进行分类,例如country有一个外键description

{% regroup cities by country.description as country_list %}

假如country是一个选择值,我么可以使用get_country_display来显示它的string而不是key值

---

{% spceless %}去掉多余的空格

{% spaceless %}
    <p>
        <a href="foo/">Foo</a>
    </p>
{% endspaceless %}

效果如下:

<p><a href="foo/">Foo</a></p>

但是只有紧挨着的标签内的空格才会去除,内部的标签空格不会去掉.

{% spaceless %}
    <strong>
        Hello
    </strong>
{% endspaceless %}

<strong>里的空格就不会去掉.

---

url传参

{% url 'path.to.some_view' v1 v2 %}
{% url 'path.to.some_view' arg1=v1 arg2=v2 %}

我们可以在url中使用as参数

{% url 'path.to.view' arg arg2 as the_url %}

就可以在页面其他地方使用

<a href="{{ the_url }}">I'm linking to {{ the_url }}</a>

---

{% verbatim %} {% endverbatim %}禁止template render该内容.

---

重命名变量内容,减少输入

{% with total=business.employees.count %}
    {{ total }} employee{{ total|pluralize }}
{% endwith %}

也可以

{% with alpha=1 beta=2 %}
    ...
{% endwith %}

---

排序

{{ value|dictsort:"name" }}

假如value是

[
    {'name': 'zed', 'age': 19},
    {'name': 'amy', 'age': 22},
    {'name': 'joe', 'age': 31},
]

排序后的输出为

[
    {'name': 'amy', 'age': 22},
    {'name': 'joe', 'age': 31},
    {'name': 'zed', 'age': 19},
]

{% for book in books|dictsort:"author.age" %}
    * {{ book.title }} ({{ book.author.name }})
{% endfor %}

---

可整除

{{ value|divisibleby:"3" }}

---

过去了多长时间

{{ blog_date|timesince:comment_date }} 评论的时间距博客发表时间过了多久.

还多长时间

{{ conference_date|timeuntil:from_date }} from_data距conference_data还多长时间.

---

截取字符

{{ value|truncatechars:9 }}  例如value是"Joel is a slug"输出会是"Joel i..."

{{ value|truncatechars_html:9 }} 假如value是"<p>Joel is a slug<p>"输出会是<p>Joel i...</p>

{{ value|truncatewords:2 }} 假如value是"Joel is a slug"输出会是"Joel is..."

{{ value|truncatewords_html:2 }} 假如value是"<p>Joel is a slug<p>"输出会是<p>Joel is...</p>

---

{{ value|urlencode:"" }} If value is "http://www.example.org/", the output will be "http%3A%2F%2Fwww.example.org%2F".

---

{{ value|yesno:"yeah,no,maybe" }}

---

{% load static %}
{% static "images/hi.jpg" as myphoto %}
<img src="{{ myphoto }}"></img>

等价于

{% load static %}
<img src="{% get_static_prefix %}images/hi.jpg" alt="Hi!" />