Jinja2模版过滤器 控制语句

 Jinja2模版过滤器

过滤器是通过管道符号（|）进行使用的，例如：{{ name|length }}，将返回name的长度。过滤器相当于是一个函数，把当前的变量传入到过滤器中，然后过滤器根据自己的功能，再返回相应的值，之后再将结果渲染到页面中。Jinja2中内置了许多过滤器，在这里可以看到所有的过滤器，现对一些常用的过滤器进行讲解：

1. abs(value)：返回一个数值的绝对值。 例如：-1|abs。

2. default(value,default_value,boolean=false)：如果当前变量没有值，则会使用参数中的值来代替。name|default('xiaotuo')——如果name不存在，则会使用xiaotuo来替代。boolean=False默认是在只有这个变量为undefined的时候才会使用default中的值，如果想使用python的形式判断是否为false，则可以传递boolean=true。也可以使用or来替换。

3. escape(value)或e：转义字符，会将<、>等符号转义成HTML中的符号。例如：content|escape或content|e。

4. first(value)：返回一个序列的第一个元素。names|first。

5. format(value,*arags,**kwargs)：格式化字符串。例如以下代码：

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

   将输出：Helloo? - Foo!

6. last(value)：返回一个序列的最后一个元素。示例：names|last。

7. length(value)：返回一个序列或者字典的长度。示例：names|length。

8. join(value,d=u'')：将一个序列用d这个参数的值拼接成字符串。

9. safe(value)：如果开启了全局转义，那么safe过滤器会将变量关掉转义。示例：content_html|safe。

10. int(value)：将值转换为int类型。

11. float(value)：将值转换为float类型。

12. lower(value)：将字符串转换为小写。

13. upper(value)：将字符串转换为小写。

14. replace(value,old,new)： 替换将old替换为new的字符串。

15. truncate(value,length=255,killwords=False)：截取length长度的字符串。

16. striptags(value)：删除字符串中所有的HTML标签，如果出现多个空格，将替换成一个空格。

17. trim：截取字符串前面和后面的空白字符。

18. string(value)：将变量转换成字符串。

19. wordcount(s)：计算一个长字符串中单词的个数。

 控制语句

所有的控制语句都是放在{% ... %}中，并且有一个语句{% endxxx %}来进行结束，Jinja中常用的控制语句有if/for..in..，现对他们进行讲解：

1. if：if语句和python中的类似，可以使用>，<，<=，>=，==，!=来进行判断，也可以通过and，or，not，()来进行逻辑合并操作，以下看例子：

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

2. for...in...：for循环可以遍历任何一个序列包括列表、字典、元组。并且可以进行反向遍历，以下将用几个例子进行解释：

   • 普通的遍历：

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

   • 遍历字典：

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

   • 如果序列中没有值的时候，进入else：

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

      并且Jinja中的for循环还包含以下变量，可以用来获取当前的遍历状态：

                另外，不可以使用continue和break表达式来控制循环的执行。