过滤器(filter)

时间:2024-03-02 11:28:48

作用:

Django过滤器的作用是对管道符 ‘|’前面的变量进行修饰 然后在页面中显示修饰后的结果

语法:

{{变量名|filter_name:参数}} 

 

 

注意事项:

    1. 过滤器支持“链式”操作。即一个过滤器的输出作为另一个过滤器的输入。
    2. 过滤器可以接受参数,例如:{{ sss|truncatewords:30 }},这将显示sss的前30个词。
    3. 过滤器参数包含空格的话,必须用引号包裹起来。比如使用逗号和空格去连接一个列表中的元素,如:{{ list|join:\', \' }}
    4. \'|\'左右没有空格没有空格没有空格 

内置过滤器:

 

一、形式:小写 {{ name | lower }}

二、串联:先转义文本到HTML,再转换每行到 <p> 标签 {{ my_text|escape|linebreaks }}

三、过滤器的参数 显示前30个字 {{ bio | truncatewords:"30" }}

格式化 {{ pub_date | date:"F j, Y" }}

 

过滤器列表

{{ 123|add:"5" }} 给value加上一个数值

{{ "AB\'CD"|addslashes }} 单引号加上转义号,一般用于输出到javascript中

{{ "abcd"|capfirst }} 第一个字母大写

{{ "abcd"|center:"50" }} 输出指定长度的字符串,并把值对中

{{ "123spam456spam789"|cut:"spam" }} 查找删除指定字符串

{{ value|date:"F j, Y" }} 格式化日期

{{ value|default:"(N/A)" }} 值不存在,使用指定值

{{ value|default_if_none:"(N/A)" }} 值是None,使用指定值

{{ 列表变量|dictsort:"数字" }} 排序从小到大

{{ 列表变量|dictsortreversed:"数字" }} 排序从大到小

{% if 92|divisibleby:"2" %} 判断是否整除指定数字

 

{{ string|escape }} 转换为html实体

{{ 21984124|filesizeformat }} 以1024为基数,计算最大值,保留1位小数,增加可读性

{{ list|first }} 返回列表第一个元素

{{ "ik23hr&jqwh"|fix_ampersands }} &转为&amp;

{{ 13.414121241|floatformat }} 保留1位小数,可为负数,几种形式

{{ 13.414121241|floatformat:"2" }} 保留2位小数

{{ 23456 |get_digit:"1" }} 从个位数开始截取指定位置的1个数字

 

{{ list|join:", " }} 用指定分隔符连接列表

{{ list|length }} 返回列表个数

{% if 列表|length_is:"3" %} 列表个数是否指定数值

{{ "ABCD"|linebreaks }} 用新行用<p> 、 <br /> 标记包裹

{{ "ABCD"|linebreaksbr }} 用新行用<br /> 标记包裹

{{ 变量|linenumbers }} 为变量中每一行加上行号

{{ "abcd"|ljust:"50" }} 把字符串在指定宽度中对左,其它用空格填充

 

{{ "ABCD"|lower }} 小写

{% for i in "1abc1"|make_list %}ABCDE,{% endfor %} 把字符串或数字的字符个数作为一个列表

{{ "abcdefghijklmnopqrstuvwxyz"|phone2numeric }} 把字符转为可以对应的数字??

{{ 列表或数字|pluralize }} 单词的复数形式,如列表字符串个数大于1,返回s,否则返回空串

 

{{ 列表或数字|pluralize:"es" }} 指定es

{{ 列表或数字|pluralize:"y,ies" }} 指定ies替换为y

{{ object|pprint }} 显示一个对象的值

{{ 列表|random }} 返回列表的随机一项

{{ string|removetags:"br p div" }} 删除字符串中指定html标记

{{ string|rjust:"50" }} 把字符串在指定宽度中对右,其它用空格填充

 

{{ 列表|slice:":2" }} 切片

{{ string|slugify }} 字符串中留下减号和下划线,其它符号删除,空格用减号替换

{{ 3|stringformat:"02i" }} 字符串格式,使用Python的字符串格式语法

{{ "E<A>A</A>B<C>C</C>D"|striptags }} 剥去[X]HTML语法标记

{{ 时间变量|time:"P" }} 日期的时间部分格式

{{ datetime|timesince }} 给定日期到现在过去了多少时间

{{ datetime|timesince:"other_datetime" }} 两日期间过去了多少时间

 

{{ datetime|timeuntil }} 给定日期到现在过去了多少时间,与上面的区别在于2日期的前后位置。

{{ datetime|timeuntil:"other_datetime" }} 两日期间过去了多少时间

{{ "abdsadf"|title }} 首字母大写

{{ "A B C D E F"|truncatewords:"3" }} 截取指定个数的单词

{{ "<a>1<a>1<a>1</a></a></a>22<a>1</a>"|truncatewords_html:"2" }} 截取指定个数的html标记,并补完整

<ul>{{ list|unordered_list }}</ul> 多重嵌套列表展现为html的无序列表

 

{{ string|upper }} 全部大写

<a href="{{ link|urlencode }}">linkage</a> url编码

{{ string|urlize }} 将URLs由纯文本变为可点击的链接。(没有实验成功)

{{ string|urlizetrunc:"30" }} 同上,多个截取字符数。(同样没有实验成功)

 

{{ "B C D E F"|wordcount }} 单词数

{{ "a b c d e f g h i j k"|wordwrap:"5" }} 每指定数量的字符就插入回车符

{{ boolean|yesno:"Yes,No,Perhaps" }} 对三种值的返回字符串,对应是 非空,空,None

 

日起格式化

{{ pub_date | date:"F j, Y" }} 

日期格式化参数

格式化字符描述示例输出
a \'a.m.\'\'p.m.\'(请注意,这与PHP的输出略有不同,因为这包括符合Associated Press风格的期间) \'a.m.\'
A \'AM\'\'PM\' \'AM\'
b 月,文字,3个字母,小写。 \'jan\'
B 未实现。  
c ISO 8601格式。 (注意:与其他格式化程序不同,例如“Z”,“O”或“r”,如果值为naive datetime,则“c”格式化程序不会添加时区偏移量(请参阅datetime.tzinfo) 。 2008-01-02T10:30:00.000123+02:002008-01-02T10:30:00.000123如果datetime是天真的
d 月的日子,带前导零的2位数字。 \'01\'\'31\'
D 一周中的文字,3个字母。 “星期五”
e 时区名称 可能是任何格式,或者可能返回一个空字符串,具体取决于datetime。 \'\'\'GMT\'\'-500\'\'US/Eastern\'
E 月份,特定地区的替代表示通常用于长日期表示。 \'listopada\'(对于波兰语区域,而不是\'Listopad\'
f 时间,在12小时的小时和分钟内,如果它们为零,则分钟停留。 专有扩展。 \'1\'\'1:30\'
F 月,文,长。 \'一月\'
g 小时,12小时格式,无前导零。 \'1\'\'12\'
G 小时,24小时格式,无前导零。 \'0\'\'23\'
h 小时,12小时格式。 \'01\'\'12\'
H 小时,24小时格式。 \'00\'\'23\'
i 分钟。 \'00\'\'59\'
I 夏令时间,无论是否生效。 \'1\'\'0\'
j 没有前导零的月份的日子。 \'1\'\'31\'
l 星期几,文字长。 \'星期五\'
L 布尔值是否是一个闰年。 TrueFalse
m 月,2位数字带前导零。 \'01\'\'12\'
M 月,文字,3个字母。 “扬”
n 月无前导零。 \'1\'\'12\'
N 美联社风格的月份缩写。 专有扩展。 \'Jan.\'\'Feb.\'\'March\'\'May\'
o ISO-8601周编号,对应于使用闰年的ISO-8601周数(W)。 对于更常见的年份格式,请参见Y。 \'1999年\'
O 与格林威治时间的差异在几小时内。 \'+0200\'
P 时间为12小时,分钟和\'a.m。\'/\'p.m。\',如果为零,分钟停留,特殊情况下的字符串“午夜”和“中午”。 专有扩展。 \'1 am\'\'1:30 pm\' / t3>,\'midnight\'\'noon\'\'12:30 pm\' / T10>
r RFC 5322格式化日期。 \'Thu, 21 Dec 2000 16:01:07 +0200\'
s 秒,带前导零的2位数字。 \'00\'\'59\'
S 一个月的英文序数后缀,2个字符。 \'st\'\'nd\'\'rd\'\'th\'
t 给定月份的天数。 28 to 31
T 本机的时区。 \'EST\'\'MDT\'
u 微秒。 000000 to 999999
U 自Unix Epoch以来的二分之一(1970年1月1日00:00:00 UTC)。  
w 星期几,数字无前导零。 \'0\'(星期日)至\'6\'(星期六)
W ISO-8601周数,周数从星期一开始。 153
y 年份,2位数字。 \'99\'
Y 年,4位数。 \'1999年\'
z 一年中的日子 0365
Z 时区偏移量,单位为秒。 UTC以西时区的偏移量总是为负数,对于UTC以东时,它们总是为正。 -4320043200

 

 

 

自定义过滤器:

因为内置过滤器满足不了我们,所以需要自定义过滤器,只需要遵循Django的规则创建即可

 

自定义filter的创建及使用:

创建:

  1.在app目录下创建templatetags的package包

  2.然后在templatetags下创建一个python文件:my_filters.py

  3.在py文件内写函数:def filter_name(value,arg):     # value参数是管道符前面需要修改的变量,arg是过滤器的‘:’后面的参数

  4.导入包from Django import template

  5.register  = template.Library()

  6.对my_filter函数进行装饰  @register.filter

使用:

  1.重启django项目

  2.模板中需要导入my_filters.py文件 {% load my_filters %}

  3.使用自定义过滤器{{变量|filter_name:arg}}有arg参数 或 {{变量|filter_name}} 没有arg参数  

 

  注:

    1.函数名可以作为过滤器名在django的模板中使用,或者可以在装饰器中对名字进行设置@register.filter(name=\'filter_name\')

自定义filter参数的扩展:

filter的参数除了要修饰的变量外最多只能有一个参数,如果需要多个参数的情况时,可以传入多个参数中间用\',\'隔开

例:

  {{变量名|filter_name:\'参数1,参数2,参数3\'}}     # 这种方式只能是字符串的形式

  后端过滤器函数进行处理时可以用arg.split(\',\')方法来获取到多个参数。