http://docs.jinkan.org/docs/jinja2/
摘自
http://www.pythontip.com/blog/post/5455/
数学运算 +, -, *, /, **, //, %等数学运算符都支持.
逻辑运算 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, 转换成一个<a>标签表示的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</h1>
<ul>
{% for user in users %}
<li>{{ user.username|e }}</li>
{% endfor %}
</ul>
在循环内部，你可以访问一些特殊的变量
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<div class="{{ class }}">
13<h2>{{ title }}</h2>
14<div class="contents">
15 {{ caller() }}
16 </div>
17</div>
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 %}