PythonTip >> 博文 >> Django

模板jinja2常用方法

zihua 2014-01-16 18:01:16 点击: 101813 | 收藏


数学运算       +, -, *, /, **, //, %等数学运算符都支持.

逻辑运算       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://my.oschina.net/zuoan001/blog/75874

作者:zihua | 分类: Django | 标签: django | 阅读: 101813 | 发布于: 2014-01-16 18时 |