模板jinja2常用方法

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 %}

在尝试学习新的语言之前先理解这门语言的设计原理能够让你在探索这门新语言时保持一个清醒而且开发的状态。

 

 

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 %}