Django入门：template之过滤器

【转载】 
原作者写的基本上把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的值增加2
1
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 <a href=”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)