酷应用

搞定 Django 模板内置标签！

百家作者：程序人生 2019-10-01 03:23:11

作者 | 单雨

责编 | 胡巍巍

出品 | 程序人生（ID：coder_life）

1.debug

概述?：

输出整体的调试信息，包括当前上下文和导入的模块。示例：

django
{%?for?o?in?list?%}
????
class="{%?cycle?'row_blue'?'row_green'?as?rowcolor?silent?%}">div>
????{%?debug?%}
{%?endfor?%}

这个标签会输出非常多的信息，通常只有前几行是有用的，如图：

2.filter?

概述?：

对包含在其中的内容进行过滤。用法：

django
{%?filter?force_escape?%}
???{需要转义的内容}
{%?endfilter?%}

传入参数：

filter标签可以传入参数，比如上述的force_escape（强制转义），可以传入多个参数，参数之间通过“|”进行分隔：

django
{%?filter?force_escape|upper?%}
???{需要转义的内容}
{%?endfilter?%}

传入参数`{“myname”:"jack"}`渲染效果：

小写字母经过过滤变成了大写。?

3. firstof?

概述?：

输出第一个不是False，不是空值或数字0的值，如果所有的值都是False，空值或者数字0就什么都不输出。使用示例：

django
{%?firstof?a1?a2?a3?a4?a5?a6?%}

传入参数：

`python
{
????????"myname":?"jack",
????????"a1":?False,
????????"a2":?0,
????????"a3":?"",
????????"a4":?True,
????????"a5":?1,
????????"a6":?"a6"
}

渲染效果：

可见第一个不是False的变量是a4。?

返回默认字符串?：

firstof标签也可以设置一个在所有值都是False的情况下返回的字符串。示例：

django
{%?firstof?a1?a2?a3?"所有值都是空值"?%}

渲染效果：

关闭HTML转义：

默认情况下，输出的变量内容和这个返回的字符串会自动进行HTML转义，如果想要显示一些特别的提示效果，比如红色的警告信息，可以这样：

django
{%?autoescape?off?%}
????{%?firstof?a1?a2?a3??"< span?style='color:red;'>所有值都是空值< span>"?%}
{%?endautoescape?%}

渲染效果：

这样所有的输出的变量和返回的默认字符串都不会进行自动HTML转义。?

如果只想其中的一些变量或者默认字符串不被转义，可以使用safe过滤器。示例：

django

????{%?firstof?a1|safe?a2?a3??"< span?style='color:red;'>所有值都是空值< span>"|safe?%}

只有a1和默认字符串不会被转义。

假如`"a1":"""`渲染效果：

可以看到变量a1没有执行HTML转义，被当做HTML代码执行了。?

输出保存到变量：

firstof标签的输出也可以存储在一个变量中，用法：?

django
{%?firstof?a1?a2?a3??as?not_false_value?%}
{{??not_false_value?}}

渲染效果：

4.for?

概述：

循环数组中的每个项，使该项在上下文变量中可用。例如展示一个列表：

django
< ul>
{%?for?city?in?city_list?%}
????< li>{{?city?}}li>
{%?endfor?%}
ul>

传入参数`{"city_list":['北京','上海','哈尔滨','沈阳'']}`，渲染效果：

倒序渲染：

django
< ul>
{%?for?city?in?city_list?reversed?%}
????< li>{{?city?}}li>
{%?endfor?%}
ul>

效果：

渲染嵌套列表：

如果需要渲染嵌套列表，可以把子列表的项解压为单独的变量，比如渲染两只球队人员名单，每队有三个成员：

django

{%?for?member1,member2,member3?in?team_list?%}
????

????????{{?member1?}},{{?member2?}},{{?member3?}}
????

{%?endfor?%}

传入参数`"team_list": [["乔丹", "詹姆斯", "哈登"], ["达尼尔", "杰斯", "本杰明"]]`，

渲染效果：?

渲染字典：

for标签也可以渲染字典，比如渲染产品价格信息：

django
{%?for?product,?price?in?data.items?%}
????
{{?product?}}:?{{?price?}}

{%?endfor?%}

注意：对于点操作符，字典键查找优先于方法查找。如果渲染的字典中包含一个名为“items”的键，则为products.items将返回products['items']，而不是products.items。如果希望在模板中使用字典方法(项、值、键等)，应该避免使用类似字典方法的键。?

for标签内置变量:

for标签内置变量的用法和普通变量一样。?

- forloop.counter：当前迭代项的索引，从1开始。

django
??{%?for?product,?price?in?products.items?%}
??????
{{?product?}}:?{{?price?}}

??????{{?forloop.counter}}{替换这个变量得到后面例子的渲染效果}
??{%?endfor?%}

- forloop.counter0：当前迭代项的索引，从0开始。

- forloop.revcounter：从循环项的末尾开始索引到1。?

- forloop.revcounter0：从循环项的末尾开始索引到0。

- forloop.first：如果是第一经过循环，则为True。?

- forloop.last：如果是最后一次经过循环，则为True。?

- forloop.parentloop：在嵌套循环中，获取当前循环的父循环。forloop.parentloop还可以用点表示法引用内置循环变量，比如：forloop.parentloop.counter、forloop.parentloop.revcounter、forloop.first。效果示例：?

使用forloop.parentloop.counter父循环的当前索引。

django
??{%?for?value?in?categorys.values?%}
??????{%?for?k,?v?in?value.items?%}
??????????
{{?k?}}:?{{?v?}}

??????????{{?forloop.parentloop.counter}}
??????{%?endfor?%}
??{%?endfor?%}

传入参数:`"categorys": {"products": {"car": "￥300000", "engine": "￥200000", "tyre": "￥2000"},"sales_volume":{"car":1000,"engine":500,"tyre":20000}, }`

渲染效果：

5.for...empty?

概述：

for标签可以使用一个可选的{% empty %}子句，如果给定数组为空或无法找到，则显示该子句的文本。用法：

django
{%?for?product,price?in?products.items?%}
????< li>{{product}}:{{price}}li>
{%?empty?%}
????< li>产品列表为空li>
{%?endfor?%}

传入参数:`"products": {}`?

渲染效果：

?相当于使用一个if-else判断：

django
{%?if?products?%}
????{%?for?product,price?in?products.items?%}
????????
{{product}}:{{price}}

????{%?endfor?%}
??{%?else?%}
????产品列表为空

??{%?endif?%}