Django入门:template之过滤器
2017-12-20 14:48
435 查看
【转载】
原作者写的基本上把django官网上的东西给翻译了,翻译地址http://python.usyiyi.cn/django/ref/templates/builtins.html#built-in-filter-reference
2
3
4
5
6
2
3
2
3
2
3
2
3
2
3
4
5
2
3
2
3
2
3
4
[
{‘name’: ‘zed’, ‘age’: 19},
{‘name’: ‘amy’, ‘age’: 22},
{‘name’: ‘joe’, ‘age’: 31},
]
那么,输出是:
[
{‘name’: ‘amy’, ‘age’: 22},
{‘name’: ‘joe’, ‘age’: 31},
{‘name’: ‘zed’, ‘age’: 19},
]
意义:如果value的值是一个字典,那么返回值是按照关键字排序的结果的反序
使用形式:与上述(8)完全相同。
使用形式:{{ value | divisibleby:arg}},如果value是21,arg是3,那么输出将是True
意义:如果value能够被arg整除,那么返回值将是True
使用形式:{{ value | escape}}
意义:替换value中的某些字符,以适应HTML格式,包括:
< is converted to
> is converted to
’ (single quote) is converted to
” (double quote) is converted to
& is converted to
escape仅仅在输出的时候才起作用,所以escape不能够用在链式过滤器的中间,
他应该总是最后一个过滤器,如果想在链式过滤器的中间使用,那么可以使用force_escape
使用形式:{{ value | escapejs }}
意义:替换value中的某些字符,以适应JAVASCRIPT和JSON格式。
使用形式:{{ value | filesizeformat }}
意义:格式化value,使其成为易读的文件大小,例如:13KB,4.1MB等。
使用形式:{{ value | first }}
意义:返回列表中的第一个Item,例如,如果value是列表[‘a’,’b’,’c’],那么输出将是’a’。
使用形式:{{ value | floatformat}}或者{{value|floatformat:arg}},
arg可以是正数也可以是负数。没有参数的floatformat相当于floatformat:-1
(1)如果不带arg,那么引擎会四舍五入,同时最多只保留一位小数。
34.23234 {{ value|floatformat }} 34.2
34.00000 {{ value|floatformat }} 34
34.26000 {{ value|floatformat }} 34.3
(2)如果arg是正数,那么引擎会四舍五入,同时保留arg位的小数。
34.23234 {{ value|floatformat:3 }} 34.232
34.00000 {{ value|floatformat:3 }} 34.000
34.26000 {{ value|floatformat:3 }} 34.260
(3)如果arg是负数,那么引擎会四舍五入,如果有小数部分,那么保留arg位小数;否则,则没有任何小数部分。
34.23234 {{ value|floatformat:”-3” }} 34.232
34.00000 {{ value|floatformat:”-3” }} 34
34.26000 {{ value|floatformat:”-3” }} 34.26
使用形式:{{ value | get_digit:”arg”}},例如,如果value是123456789,arg是2,那么输出是8
意义:给定一个数字,返回,请求的数字,记住:1代表最右边的数字,如果value不是合法输入,
那么会返回所有原有值。
使用形式:{{value | iriencode}}
意义:如果value中有非ASCII字符,那么将其进行抓化成URL中适合的编码,如果value已经进行过URLENCODE,
改操作就不会再起作用。
使用形式:{{ value | join:”arg”}},如果value是[‘a’,’b’,’c’],arg是’//’那么输出是a//b//c
意义:使用指定的字符串连接一个list,作用如同python的str.join(list)
使用形式:{{ value | last }}
意义:返回列表中的最后一个Item
使用形式:{{ value | length }}
意义:返回value的长度。
使用形式:{{ value | length_is:”arg”}}
意义:返回True,如果value的长度等于arg的时候,例如:如果value是[‘a’,’b’,’c’],arg是3,那么返回True
使用形式:{{value|linebreaks}}
意义:value中的”\n”将被
使用形式:{{value |linebreaksbr}}
意义:value中的”\n”将被
使用形式:{{value | linenumbers}}
意义:显示的文本,带有行数。
使用形式:{{value | ljust}}
意义:在一个给定宽度的字段中,左对齐显示value
使用形式:{{value | center}}
意义:在一个给定宽度的字段中,中心对齐显示value
使用形式:{{value | rjust}}
意义:在一个给定宽度的字段中,右对齐显示value
使用形式:{{value | lower}}
意义:将一个字符串转换成小写形式
使用形式:{{value | make_list}}
意义:将value转换成一个list,对于字符串,转换成字符list;对于整数,转换成整数list
例如value是Joel,那么输出将是[u’J’,u’o’,u’e’,u’l’];value是123,那么输出将是[1,2,3]
使用形式:{{value | pluralize}},或者{{value | pluralize:”es”}},或者{{value | pluralize:”y,ies”}}
意义:如果value不是1,则返回一个复数后缀,缺省的后缀是’s’
使用形式:{{value | random}}
意义:从给定的list中返回一个任意的Item
使用形式:{{value | removetags:”tag1 tag2 tag3…”}}
意义:删除value中tag1,tag2….的标签。例如,如果value是
tags是”b span”,那么输出将是:Joel
slug
使用形式:{{value | safe}}
意义:当系统设置autoescaping打开的时候,该过滤器使得输出不进行escape转换
与上述safe基本相同,但有一点不同的就是:safe是针对字符串,而safeseq是针对多个字符串组成的sequence
使用形式:{{some_list | slice:”:2”}}
意义:与python语法中的slice相同,:2表示第一的第二个元素
使用形式:{{value | slugify}}
意义:将value转换成小写形式,同事删除所有分单词字符,并将空格变成横线
例如:如果value是Joel is a slug,那么输出将是joel-is-a-slug
这个不经常用,先不说
{{ value|stringformat:”E” }}
If value is 10, the output will be 1.000000E+01.
使用形式:{{value | striptags}}
意义:删除value中的所有HTML标签
使用形式:{{value | time:”H:i”}}或者{{value | time}}
意义:格式化时间输出,如果time后面没有格式化参数,那么输出按照TIME_FORMAT中设置的进行。
转换一个字符串成为title格式。
使用形式:{{value | truncatewords:2}}
意义:将value切成truncatewords指定的单词数目
例如,如果value是Joel is a slug 那么输出将是:Joel is …
使用形式同(41)
意义:truncation点之前如果某个标签打开了,但是没有关闭,那么在truncation点会立即关闭。
因为这个操作的效率比truncatewords低,所有只有在value是html格式时,才考虑使用。
转换一个字符串为大写形式
将一个字符串进行URLEncode
意义:将一个字符串中的URL转化成可点击的形式。
使用形式:{{ value | urlize }}
例如,如果value是Check out www.djangoproject.com,那么输出将是:
Check out
使用形式:{{ value | urlizetrunc:15}}
意义:与(45)相同,但是有一点不同就是现实的链接字符会被truncate成特定的长度,后面以…现实。
返回字符串中单词的数目
使用形式:{{value | wordwrap:5}}
意义:按照指定的长度包装字符串
例如,如果value是Joel is a slug,那么输出将会是:
Joel
is a
slug
使用形式:{{value |
since:arg}}
意义:返回参数arg到value的天数和小时数
例如,如果 blog_date 是一个日期实例表示 2006-06-01 午夜, 而 comment_date 是一个日期实例表示 2006-06-01 早上8点,
那么 {{ comment_date|timesince:blog_date }} 将返回 “8 hours”.
使用形式:{{value | timeuntil}}
意义:与(50)基本相同,一个不同点就是,返回的是value距离当前日期的天数和小时数。
以下是原作者没有提到的,从原文中找到的
Converts a phone number (possibly containing letters) to its numerical equivalen
The input doesn’t have to be a valid phone number. This will happily convert any string.
For example:
{{ value|phone2numeric }}
If value is 800-COLLECT, the output will be 800-2655328.
A wrapper around pprint.pprint() – for debugging, really.
New in Django 1.7.
Similar to truncatechars, except that it is aware of HTML tags. Any tags that are opened in the string and not closed before the truncation point are closed immediately after the truncation.
For example:
{{ value|truncatechars_html:9 }}
If value is “
the output will be “
Newlines in the HTML content will be preserved.
接收一个嵌套的列表,返回一个HTML 的列表 —— 不包含开始和结束的
列表假设成具有合法的格式。例如,如果var 包含[‘States’, [‘Kansas’, [‘Lawrence’, ‘Topeka’], ‘Illinois’]], 那么{{ var|unordered_list }} 将返回:
2
3
4
5
6
7
8
9
10
11
Deprecated since version 1.8: An older, more restrictive and verbose input format is also supported: [‘States’, [[‘Kansas’, [[‘Lawrence’, []], [‘Topeka’, []]]], [‘Illinois’, []]]]. 这种语法在Django 2.0 中将不再支持。
Maps values for True, False, and (optionally) None, to the strings “yes”, “no”, “maybe”, or a custom mapping passed as a comma-separated list, and returns one of those strings according to the value:
例如:
{{ value|yesno:”yeah,no,maybe” }}
Value Argument Outputs
True yes
True “yeah,no,maybe” yeah
False “yeah,no,maybe” no
None “yeah,no,maybe” maybe
None “yeah,no” no (converts None to False if no mapping for None is given)
原作者写的基本上把django官网上的东西给翻译了,翻译地址http://python.usyiyi.cn/django/ref/templates/builtins.html#built-in-filter-reference
二、过滤器
1.可以通过过滤器来修改变量的显示,过滤器的形式是:{{ variable | filter }},管道符号'|'代表使用过滤器 2.过滤器能够采用链式的方式使用,例如:{{ text | escape | linebreaks }} 3.过滤器还可以带参数,例如: {{ bio|truncatewords:30 }} 4.过滤器的参数中如果带有空格,那么需要用引号引起来,例如:{{ list | join : ", "}} 5.django中30个内建的过滤器1
2
3
4
5
6
(1)add
使用形式为:{{ value | add: "2"}} 意义:将value的值增加21
2
3
(2)addslashes
使用形式为:{{ value | addslashes }} 意义:在value中的引号前增加反斜线1
2
3
(3)capfirst
使用形式为:{{ value | capfirst }} 意义:value的第一个字符转化成大写形式1
2
3
(4)cut
使用形式为:{{ value | cut:arg}}, 例如,如果value是“String with spaces” arg是" "那么输出是"Stringwithspaces" 意义:从给定value中删除所有arg的值1
2
3
(5)date
使用形式为:: (a) {{ value | date:"D d M Y" }},例如,如果value是一个datetime对象(datetime.datetime.now())那么输出将是字符串"Wed 09 Jan 2008" (b) {{ value | date }},这种形式没有格式化字符串,这时候,格式化字符串会自动采用DATE_FORMAT所设置的形式。 意义:将日期格式数据按照给定的格式输出1
2
3
4
5
(6)default
使用形式:{{ value | default: "nothing" }},例如,如果value是“”,那么输出将是nothing 意义:如果value的意义是False,那么输出使用缺省值1
2
3
(7)default_if_none
使用形式:{{ value | default_if_none:"nothing" }},例如,如果value是None,那么输出将是nothing 意义:如果value是None,那么输出将使用缺省值1
2
3
(8)dictsort
意义:如果value的值是一个字典,那么返回值是按照关键字排序的结果 使用形式:{{ value | dictsort:"name"}},例如, 如果value是:1
2
3
4
[
{‘name’: ‘zed’, ‘age’: 19},
{‘name’: ‘amy’, ‘age’: 22},
{‘name’: ‘joe’, ‘age’: 31},
]
那么,输出是:
[
{‘name’: ‘amy’, ‘age’: 22},
{‘name’: ‘joe’, ‘age’: 31},
{‘name’: ‘zed’, ‘age’: 19},
]
(9)dictsortreversed
意义:如果value的值是一个字典,那么返回值是按照关键字排序的结果的反序 使用形式:与上述(8)完全相同。
(10)divisibleby
使用形式:{{ value | divisibleby:arg}},如果value是21,arg是3,那么输出将是True 意义:如果value能够被arg整除,那么返回值将是True
(11)escape
使用形式:{{ value | escape}} 意义:替换value中的某些字符,以适应HTML格式,包括:
< is converted to
<
> is converted to
>
’ (single quote) is converted to
'
” (double quote) is converted to
"
& is converted to
&
escape仅仅在输出的时候才起作用,所以escape不能够用在链式过滤器的中间,
他应该总是最后一个过滤器,如果想在链式过滤器的中间使用,那么可以使用force_escape
(12)escapejs
使用形式:{{ value | escapejs }} 意义:替换value中的某些字符,以适应JAVASCRIPT和JSON格式。
(13)filesizeformat
使用形式:{{ value | filesizeformat }} 意义:格式化value,使其成为易读的文件大小,例如:13KB,4.1MB等。
(14)first
使用形式:{{ value | first }} 意义:返回列表中的第一个Item,例如,如果value是列表[‘a’,’b’,’c’],那么输出将是’a’。
(15)floatformat
使用形式:{{ value | floatformat}}或者{{value|floatformat:arg}}, arg可以是正数也可以是负数。没有参数的floatformat相当于floatformat:-1
(1)如果不带arg,那么引擎会四舍五入,同时最多只保留一位小数。
34.23234 {{ value|floatformat }} 34.2
34.00000 {{ value|floatformat }} 34
34.26000 {{ value|floatformat }} 34.3
(2)如果arg是正数,那么引擎会四舍五入,同时保留arg位的小数。
34.23234 {{ value|floatformat:3 }} 34.232
34.00000 {{ value|floatformat:3 }} 34.000
34.26000 {{ value|floatformat:3 }} 34.260
(3)如果arg是负数,那么引擎会四舍五入,如果有小数部分,那么保留arg位小数;否则,则没有任何小数部分。
34.23234 {{ value|floatformat:”-3” }} 34.232
34.00000 {{ value|floatformat:”-3” }} 34
34.26000 {{ value|floatformat:”-3” }} 34.26
(16)get_digit
使用形式:{{ value | get_digit:”arg”}},例如,如果value是123456789,arg是2,那么输出是8 意义:给定一个数字,返回,请求的数字,记住:1代表最右边的数字,如果value不是合法输入,
那么会返回所有原有值。
(17)iriencode
使用形式:{{value | iriencode}} 意义:如果value中有非ASCII字符,那么将其进行抓化成URL中适合的编码,如果value已经进行过URLENCODE,
改操作就不会再起作用。
(18)join
使用形式:{{ value | join:”arg”}},如果value是[‘a’,’b’,’c’],arg是’//’那么输出是a//b//c 意义:使用指定的字符串连接一个list,作用如同python的str.join(list)
(19)last
使用形式:{{ value | last }} 意义:返回列表中的最后一个Item
(20)length
使用形式:{{ value | length }} 意义:返回value的长度。
(21)length_is
使用形式:{{ value | length_is:”arg”}} 意义:返回True,如果value的长度等于arg的时候,例如:如果value是[‘a’,’b’,’c’],arg是3,那么返回True
(22)linebreaks
使用形式:{{value|linebreaks}} 意义:value中的”\n”将被
<br/>替代,并且整个value使用
</p>包围起来,从而适和HTML的格式
(23)linebreaksbr
使用形式:{{value |linebreaksbr}} 意义:value中的”\n”将被
<br/>替代
(24)linenumbers
使用形式:{{value | linenumbers}} 意义:显示的文本,带有行数。
(25)ljust
使用形式:{{value | ljust}} 意义:在一个给定宽度的字段中,左对齐显示value
(26)center
使用形式:{{value | center}} 意义:在一个给定宽度的字段中,中心对齐显示value
(27)rjust
使用形式:{{value | rjust}} 意义:在一个给定宽度的字段中,右对齐显示value
(28)lower
使用形式:{{value | lower}} 意义:将一个字符串转换成小写形式
(29)make_list
使用形式:{{value | make_list}} 意义:将value转换成一个list,对于字符串,转换成字符list;对于整数,转换成整数list
例如value是Joel,那么输出将是[u’J’,u’o’,u’e’,u’l’];value是123,那么输出将是[1,2,3]
(30)pluralize
使用形式:{{value | pluralize}},或者{{value | pluralize:”es”}},或者{{value | pluralize:”y,ies”}} 意义:如果value不是1,则返回一个复数后缀,缺省的后缀是’s’
(31)random
使用形式:{{value | random}} 意义:从给定的list中返回一个任意的Item
(32)removetags
使用形式:{{value | removetags:”tag1 tag2 tag3…”}} 意义:删除value中tag1,tag2….的标签。例如,如果value是
<b>Joel
</b>
<button>is
</button>a
<span>slug
</span>
tags是”b span”,那么输出将是:Joel
<button>is
</button>a
slug
(33)safe
使用形式:{{value | safe}} 意义:当系统设置autoescaping打开的时候,该过滤器使得输出不进行escape转换
(34)safeseq
与上述safe基本相同,但有一点不同的就是:safe是针对字符串,而safeseq是针对多个字符串组成的sequence
(35)slice
使用形式:{{some_list | slice:”:2”}} 意义:与python语法中的slice相同,:2表示第一的第二个元素
(36)slugify
使用形式:{{value | slugify}} 意义:将value转换成小写形式,同事删除所有分单词字符,并将空格变成横线
例如:如果value是Joel is a slug,那么输出将是joel-is-a-slug
(37)stringformat
这个不经常用,先不说 {{ value|stringformat:”E” }}
If value is 10, the output will be 1.000000E+01.
(38)striptags
使用形式:{{value | striptags}} 意义:删除value中的所有HTML标签
(39)time
使用形式:{{value | time:”H:i”}}或者{{value | time}} 意义:格式化时间输出,如果time后面没有格式化参数,那么输出按照TIME_FORMAT中设置的进行。
(40)title
转换一个字符串成为title格式。
(41)truncatewords
使用形式:{{value | truncatewords:2}} 意义:将value切成truncatewords指定的单词数目
例如,如果value是Joel is a slug 那么输出将是:Joel is …
(42)truncatewords_html
使用形式同(41) 意义:truncation点之前如果某个标签打开了,但是没有关闭,那么在truncation点会立即关闭。
因为这个操作的效率比truncatewords低,所有只有在value是html格式时,才考虑使用。
(43)upper
转换一个字符串为大写形式
(44)urlencode
将一个字符串进行URLEncode
(45)urlize
意义:将一个字符串中的URL转化成可点击的形式。 使用形式:{{ value | urlize }}
例如,如果value是Check out www.djangoproject.com,那么输出将是:
Check out
<ahref=”http://www.djangoproject.com”>www.djangoproject.com
</a>
(46)urlizetrunc
使用形式:{{ value | urlizetrunc:15}} 意义:与(45)相同,但是有一点不同就是现实的链接字符会被truncate成特定的长度,后面以…现实。
(47)wordcount
返回字符串中单词的数目
(48)wordwrap
使用形式:{{value | wordwrap:5}} 意义:按照指定的长度包装字符串
例如,如果value是Joel is a slug,那么输出将会是:
Joel
is a
slug
(49)timesince
使用形式:{{value | since:arg}}
意义:返回参数arg到value的天数和小时数
例如,如果 blog_date 是一个日期实例表示 2006-06-01 午夜, 而 comment_date 是一个日期实例表示 2006-06-01 早上8点,
那么 {{ comment_date|timesince:blog_date }} 将返回 “8 hours”.
(50)timeuntil
使用形式:{{value | timeuntil}} 意义:与(50)基本相同,一个不同点就是,返回的是value距离当前日期的天数和小时数。
以下是原作者没有提到的,从原文中找到的
(51)phone2numeric
Converts a phone number (possibly containing letters) to its numerical equivalen The input doesn’t have to be a valid phone number. This will happily convert any string.
For example:
{{ value|phone2numeric }}
If value is 800-COLLECT, the output will be 800-2655328.
(52)pprint
A wrapper around pprint.pprint() – for debugging, really.
(53)truncatechars_html¶
New in Django 1.7.Similar to truncatechars, except that it is aware of HTML tags. Any tags that are opened in the string and not closed before the truncation point are closed immediately after the truncation.
For example:
{{ value|truncatechars_html:9 }}
If value is “
<p>Joel is a slug
</p>“,
the output will be “
<p>Joel i…
</p>“.
Newlines in the HTML content will be preserved.
(54)unordered_list
接收一个嵌套的列表,返回一个HTML 的列表 —— 不包含开始和结束的<ul>标签。
列表假设成具有合法的格式。例如,如果var 包含[‘States’, [‘Kansas’, [‘Lawrence’, ‘Topeka’], ‘Illinois’]], 那么{{ var|unordered_list }} 将返回:
<li>States <ul> <li>Kansas <ul> <li>Lawrence</li> <li>Topeka</li> </ul> </li> <li>Illinois</li> </ul> </li>1
2
3
4
5
6
7
8
9
10
11
Deprecated since version 1.8: An older, more restrictive and verbose input format is also supported: [‘States’, [[‘Kansas’, [[‘Lawrence’, []], [‘Topeka’, []]]], [‘Illinois’, []]]]. 这种语法在Django 2.0 中将不再支持。
(55)yesno¶
Maps values for True, False, and (optionally) None, to the strings “yes”, “no”, “maybe”, or a custom mapping passed as a comma-separated list, and returns one of those strings according to the value:例如:
{{ value|yesno:”yeah,no,maybe” }}
Value Argument Outputs
True yes
True “yeah,no,maybe” yeah
False “yeah,no,maybe” no
None “yeah,no,maybe” maybe
None “yeah,no” no (converts None to False if no mapping for None is given)
相关文章推荐
- Django入门:template之过滤器
- django template language入门
- Django template 过滤器
- Django——模板层(template)(模板语法、自定义模板过滤器及标签、模板继承)
- django--模版系统-过滤器的自定义,两种加载模版(template)的方法
- django入门笔记4- template
- Django4.1_template之变量和过滤器
- django template 过滤器
- django_template基础标签以及过滤器
- python Django 1.7 中文入门 (官网) 04 设计model
- Django入门-6:视图(URLconf使用)
- Django入门探索(一)
- Asp.Net MVC3 简单入门详解过滤器Filter
- Why we need template on Django ?
- Django Template filter
- 在Django中自定义filter并在template中使用
- django使用模板template时可能遇到的错误
- servlet过滤器简单入门
- django 过滤器 、日期格式化参数
- web入门-Servlet与过滤器