Jinja2常用方法

转自:https://my.oschina.net/zuoan001/blog/75874

数学运算 +, -, *, /, **, //, %等数学运算符都支持.
逻辑运算 and, or, not也同样支持

1. in 判断元素是否在集合中

2. | 管道操作符, 默认使用Apply调用一个方法

3. ~ 字符串连接

4. () 调用可调用对象

5. . 和 [ ]获取属性

6. 三元操作: value1 if expression else value2支持

7. 内建filter: (对于内建filter的别名, 可以在jinja2的filters.py文件中查找)

8. abs(number) 返回一个值的绝对值

9. batch(value, lincount, fill_with = None): 接受的value是一个序列对象, linecount表明个数, 最后生成一个列表, 列表个数为linecount, 如果提供的value长度小于 linecount, 不足的使用fill_with填充

10. capitalize(string): 接受一个字符串, 将其转换为首字母大写, 其他字母小写的形式返回

11. center(value, width = 80): 接受一个字符串, 将其至于80的长度中居中, 不足的字符使用空格填充

12. default(value, default_value = u””, boolean = False): 返回value指定的变量的值, 如果value是Undefined那么返回default_value指定的值, boolean意义未知

13. dictsort(value, case_sensitive = False, by = ‘key’): value 为要遍历的字典, case_sensitive指示是否立即加载, 设置为False表示延时加载, by表示以什么排序, 可以通过设置 by = ‘value’来以值排序.

14. escape(string): 返回一个转码的安全HTML

15. filesizeformat(value): 接受一个数值, 返回人易读的文件大小表示.

16. first(sequence): 返回序列的第一个元素

17. float(value, default = 0.0): 将接受到的value转换成float类型, 如果转换失败返回指定的default值

18. forceescape(value): 强制进行HTML转码, 也就是说不检查要转码的字符串是否是标记为安全的,这样可能会发生二次转码

19. format(value, *attribute): 类似于字符串格式化’%d %s’这样的功能value是格式定义, attribute不定参数接受占位符代表的值.

20. groupby(value, attribute): 按照指定的共有属性将集合进行分组, 返回元组组成的列表, 元组中第一个元素是用来分组的属性的值, 第二个元素是分组得到的所有原集合元素的列表.

21. indent(string, width = 4, indentfirst = False): 将接受到的string, 每行缩进width指定的字符数, indentfirst用来指定首行是否缩进.

22. int(value, default = 0): 将接受到的value转换成int型, 如果转换失败, 返回default指定的值

23. join(value, d = u””): 接受一个序列类型的对象, 向序列中进行插空d指定的字符串返回一个字符串

24. last(seq): 返回指定序列的最后一个元素

25. length(obj): 返回序列或者字典的项数

26. list(value): 将接受到的value转换成一个list

27. lower(string): 将接受到的字符串转换成小写形式.

28. pprint(value, verbose = False): 漂亮的打印一个变量的值, 多用于调试, verbose表示是否显示冗长的信息

29. random(seq): 接受一个序列对象, 随机返回其中的一个元素

30. replace(string, old, new, count = None): 接受一个字符串, 将其中的old表示的子串替换成new指定的子串, 从左到右替换count次, 如果count不指定, 则替换一次

31. reverse(value): 接受一个可迭代对象, 返回逆序的迭代器

32. round(value, precision = 0, method = ‘common’): 舍 去运算, 接受一个值, precision表示精度(小数点后保留几位), method可以取值common | ceil | floor, 分别 表示四舍五入 | 进位 | 舍去

33. safe(value): 标记传入的value值是安全的, 使用escape转码时不会发生二次转码

34. slice(value, slices, fill_width = None): 切片, 接受一个可迭代对象, 返回slices指定的前n个元素, 不足n个使用fill_width指定的对象进行填充

35. sort(value, reverse = False): 接受一个序列对象, 进行排序, reverse指定是否逆序

36. string(obj): 接受一个对象, 转换成一个string字符串

37. striptags(values): 接受一个字符串, 剥离SGML/XML标签, 并且将多个空白字符转换成单空格

38. sum(sequence, start = 0): 接受一个序列对象, 返回序列对象的元素和start的总和, 如果指定的序列对象是空的, 就返回start指定的值

39. title(string): 将接受到的字符串转换成标题模式, 即每个单词的首字母大写

40. trim(value): 去掉字符串开始和末尾多余的空白字符

41. truncate(string, length = 255, killwords = False, end = “…”): 切 断接受到的字符串, 截取前length个字符, 如果字符串比length长, 切断后追加end指定的字符串, 如果 killwords = True可以返回, 如果killwords = False不会有任何输出, 不明白.

42. upper(string) 把接受到的字符串转成大写

43. urlize(value, trim_url_limit = None, nofollow = False): 接 受一个url, 转换成一个标签表示的link, 这个link的href为传入的url, innerText是url截取前 trim_url_limit个字符, nofollow设置为true时, 会为这个link加入一个属性 rel=’nofollow’

44. wordcount(string): 计算string中的单词数

45. wordwrap(string, width = 79, break_long_words = True): 返 回经过包装的width指定宽度的字符, 也就是说每读取width个字符就会换行. , break_long_words表明在获取到width个字 符之后, 如果一个单词还没有结束, 是否截断单词, False将不会截断

46. xmlattr(d, autospace = True): 通过接受一个字典, 创建一个SGML/XML属性列表, 例如:

 <ul {{ {‘class’ = ‘my_list’, ‘missing’: none, ‘id’: ‘list’} | xmlattr }} />

  可以得到输出

 <ul class=’my_list’ id=’list’ />

  字典中指定的值为none的, 将不会被解析成标签属性.

23 内建测试:

23.1 callable(object): 测试一个对象是否是可调用对象

23.2 defined(value): 测试传入的对象是否已经定义了

23.3 divisibleby(value, num)测试传入的数值是否可以被num整除

23.4 escaped(value): 检查传入的对象是否被转码了

23.5 even(value): 如果传入的对象是even的返回True, 不懂even是什么样的对象

23.6 iterable(value): 检查对象是否是可迭代的

23.7 lower(value): 检查传入的字符串是否都是小写

23.8 none(value): 检查对象是否是空对象None

23.9 number(value): 检查对象是否是一个数字

23.10 odd(value): 检查传入的数字是否是奇数

23.11 sameas(value, other): 检查传入的对象和other指定的对象是否在内存中的同一块地址(同一个对象)

23.12 sequence(value): 检查对象是否是序列, 序列同样是可迭代对象

23.13 string(value): 检查对象是否是string

23.14 undefined(value): 检查一个对象是否未定义

23.15 upper(value): 检查一个字符串是否全部大写

24 全局函数:

24.1 range([start, ]stop[, step]):

{% for i in range(10) %}

    {{ i }}

｛% endfor %}

24.2 lipsum(n = 5, html = True, min = 20, max = 100): 不知道用途

24.3 dict(**items) 根据传入的关键字参数构造一个字典对象.

for

循环打印一个序列，例如：

h1>Members

{% for user in users %}

• {{ user.username|e }}

• {% endfor %}

  在循环内部，你可以访问一些特殊的变量

  Variable Description

  loop.index 当 前迭代的索引，从1开始算

  loop.index0 当前迭代的索引，从0开始算

  loop.revindex 相 对于序列末尾的索引，从1开始算

  loop.revindex0 相对于序列末尾的索引，从0开始算

  loop.first 相 当于 loop.index == 1.

  loop.last 相当于 loop.index == len(seq) - 1

  loop.length 序列的长度.

  loop.cycle 是 一个帮助性质的函数，可以接受两个字符串参数，如果当前循环索引是偶数，则显示第一个字符串，是奇数则显示第二个字符串。它常被在表格中用来用不同的背景 色区分相邻的行。

  设置变量值 {% set variable_name = value %}

  宏

  {% macro last_tweets(count=20) %}

     <div class=twitter>
  
     {% for tweet in models.twitter.get_last_tweets(count) %}
  
       <p><a href="{{ tweet.url|e }}">{{ tweet.username|e }}</a>:
  
          {{ tweet.parsed_text }}
  
     {% endfor %}
  
     </div>
  
   {% endmacro %} 
  

  Why do you need an extension for that? A function is perfectly fine:

    from jinja2 import contextfunction
  
    @contextfunction
  
    def widget(context, template_name, **extra_context):
  
        t = jinja_env.get_template('widgets/' + template_name)
  
        ctx = dict(context.items())
  
        ctx.update(extra_context)
  
        return t.render(ctx)
  
    jinja_env.globals['widget'] = widget
  

  And then in the template::

   {{ widget('last_tweets.html') }} 
  

  1{% set navigation = [(‘index.html’, ‘Index’), (‘about.html’, ‘About’)] %}

  2{% set key, value = call_something() %}

  global functions和filters类似，注册方法都是将其保存于Environment中，前者保存在Environment.globals字典中，后者保存在Environment.filters字典中即可。

  01 env.filters[‘filter_name’] = filter_func

  02 env.filters[‘globalfunction_name’] = global_func

  03 macro:

  04 {% macro input(name, value=’’, type=‘text’, size=20) %}

  05<input name="{{ name }}" value="{{

  06 value|e }}" size="{{ size }}" type="{{ type }}">

  07 {% endmacro %}

  08

  09{{ input(‘username’) }}

  10

  11 {% macro render_dialog(title, class=‘dialog’) -%}

  12

  13

  {{ title }}

  14

  15 {{ caller() }}

  16

  17

  18

  19 {%- endmacro %}

  20

  21 {% call render_dialog(‘Hello World’) %}

  22 This is a simple dialog rendered by using a macro and

  23 a call block.

  24 {% endcall %}