Django入门:template之过滤器
2016-07-28 17:43
525 查看
【转载】
原作者写的基本上把django官网上的东西给翻译了,翻译地址http://python.usyiyi.cn/django/ref/templates/builtins.html#built-in-filter-reference
[
{‘name’: ‘zed’, ‘age’: 19},
{‘name’: ‘amy’, ‘age’: 22},
{‘name’: ‘joe’, ‘age’: 31},
]
那么,输出是:
[
{‘name’: ‘amy’, ‘age’: 22},
{‘name’: ‘joe’, ‘age’: 31},
{‘name’: ‘zed’, ‘age’: 19},
]
使用形式:与上述(8)完全相同。
意义:如果value能够被arg整除,那么返回值将是True
意义:替换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中的某些字符,以适应JAVASCRIPT和JSON格式。
意义:格式化value,使其成为易读的文件大小,例如:13KB,4.1MB等。
意义:返回列表中的第一个Item,例如,如果value是列表[‘a’,’b’,’c’],那么输出将是’a’。
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
意义:给定一个数字,返回,请求的数字,记住:1代表最右边的数字,如果value不是合法输入,
那么会返回所有原有值。
意义:如果value中有非ASCII字符,那么将其进行抓化成URL中适合的编码,如果value已经进行过URLENCODE,
改操作就不会再起作用。
意义:使用指定的字符串连接一个list,作用如同python的str.join(list)
意义:返回列表中的最后一个Item
意义:返回value的长度。
意义:返回True,如果value的长度等于arg的时候,例如:如果value是[‘a’,’b’,’c’],arg是3,那么返回True
意义:value中的”\n”将被
意义:value中的”\n”将被
意义:显示的文本,带有行数。
意义:在一个给定宽度的字段中,左对齐显示value
意义:在一个给定宽度的字段中,中心对齐显示value
意义:在一个给定宽度的字段中,右对齐显示value
意义:将一个字符串转换成小写形式
意义:将value转换成一个list,对于字符串,转换成字符list;对于整数,转换成整数list
例如value是Joel,那么输出将是[u’J’,u’o’,u’e’,u’l’];value是123,那么输出将是[1,2,3]
意义:如果value不是1,则返回一个复数后缀,缺省的后缀是’s’
意义:从给定的list中返回一个任意的Item
意义:删除value中tag1,tag2….的标签。例如,如果value是
tags是”b span”,那么输出将是:Joel
意义:当系统设置autoescaping打开的时候,该过滤器使得输出不进行escape转换
意义:与python语法中的slice相同,:2表示第一的第二个元素
意义:将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中的所有HTML标签
意义:格式化时间输出,如果time后面没有格式化参数,那么输出按照TIME_FORMAT中设置的进行。
意义:将value切成truncatewords指定的单词数目
例如,如果value是Joel is a slug 那么输出将是:Joel is …
意义:truncation点之前如果某个标签打开了,但是没有关闭,那么在truncation点会立即关闭。
因为这个操作的效率比truncatewords低,所有只有在value是html格式时,才考虑使用。
使用形式:{{ value | urlize }}
例如,如果value是Check out www.djangoproject.com,那么输出将是:
Check out
意义:与(45)相同,但是有一点不同就是现实的链接字符会被truncate成特定的长度,后面以…现实。
意义:按照指定的长度包装字符串
例如,如果value是Joel is a slug,那么输出将会是:
Joel
is a
slug
since:arg}}
意义:返回参数arg到value的天数和小时数
例如,如果 blog_date 是一个日期实例表示 2006-06-01 午夜, 而 comment_date 是一个日期实例表示 2006-06-01 早上8点,
那么 {{ comment_date|timesince:blog_date }} 将返回 “8 hours”.
意义:与(50)基本相同,一个不同点就是,返回的是value距离当前日期的天数和小时数。
以下是原作者没有提到的,从原文中找到的
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.
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 “
Newlines in the HTML content will be preserved.
列表假设成具有合法的格式。例如,如果var 包含[‘States’, [‘Kansas’, [‘Lawrence’, ‘Topeka’], ‘Illinois’]], 那么{{ var|unordered_list }} 将返回:
Deprecated since version 1.8: An older, more restrictive and verbose input format is also supported: [‘States’, [[‘Kansas’, [[‘Lawrence’, []], [‘Topeka’, []]]], [‘Illinois’, []]]]. 这种语法在Django 2.0 中将不再支持。
例如:
{{ 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)add
使用形式为:{{ value | add: "2"}} 意义:将value的值增加2
(2)addslashes
使用形式为:{{ value | addslashes }} 意义:在value中的引号前增加反斜线
(3)capfirst
使用形式为:{{ value | capfirst }} 意义:value的第一个字符转化成大写形式
(4)cut
使用形式为:{{ value | cut:arg}}, 例如,如果value是“String with spaces” arg是" "那么输出是"Stringwithspaces" 意义:从给定value中删除所有arg的值
(5)date
使用形式为:: (a) {{ value | date:"D d M Y" }},例如,如果value是一个datetime对象(datetime.datetime.now())那么输出将是字符串"Wed 09 Jan 2008" (b) {{ value | date }},这种形式没有格式化字符串,这时候,格式化字符串会自动采用DATE_FORMAT所设置的形式。 意义:将日期格式数据按照给定的格式输出
(6)default
使用形式:{{ value | default: "nothing" }},例如,如果value是“”,那么输出将是nothing 意义:如果value的意义是False,那么输出使用缺省值
(7)default_if_none
使用形式:{{ value | default_if_none:"nothing" }},例如,如果value是None,那么输出将是nothing 意义:如果value是None,那么输出将使用缺省值
(8)dictsort
意义:如果value的值是一个字典,那么返回值是按照关键字排序的结果 使用形式:{{ value | dictsort:"name"}},例如, 如果value是:
[
{‘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 equivalenThe 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>
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)
相关文章推荐
- jQuery plugin items filter
- 全国哀悼日网站页面变成灰色的filter方法
- 用css filter做鼠标滑过图片效果
- ASP 使用Filter函数来检索数组的实现代码
- JavaScript 数组some()和filter()的用法及区别
- Vue.js报错Failed to resolve filter问题的解决方法
- ASP.NET MVC:Filter和Action的执行介绍
- jQuery遍历DOM节点操作之filter()方法详解
- jQuery中each()、find()和filter()等节点操作方法详解(推荐)
- django中使用jquery ajax post数据出现403错误的解决办法(两种方法)
- django使用ajax post数据出现403错误如何解决
- JSP Filter的应用方法
- PHP中实现Bloom Filter算法
- Jquery find与filter函数区别 说明
- windows+apache+mod_python配置django运行环境
- python Django连接MySQL数据库做增删改查
- django自定义Field实现一个字段存储以逗号分隔的字符串
- Event filter with query SELECT * FROM __InstanceModificationEvent WITHIN
- PHP内置过滤器FILTER使用实例
- Django框架利用ajax实现批量导入数据功能