作用:
Django过滤器的作用是对管道符 ‘|’前面的变量进行修饰 然后在页面中显示修饰后的结果
语法:
{{变量名|filter_name:参数}}
注意事项:
- 过滤器支持“链式”操作。即一个过滤器的输出作为另一个过滤器的输入。
- 过滤器可以接受参数,例如:{{ sss|truncatewords:30 }},这将显示sss的前30个词。
- 过滤器参数包含空格的话,必须用引号包裹起来。比如使用逗号和空格去连接一个列表中的元素,如:{{ list|join:\', \' }}
- \'|\'左右没有空格没有空格没有空格
内置过滤器:
一、形式:小写 {{ 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 }} &转为&
{{ 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:00 或2008-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 | 布尔值是否是一个闰年。 | True 或False |
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>, |
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周数,周数从星期一开始。 | 1 ,53 |
y | 年份,2位数字。 | \'99\' |
Y | 年,4位数。 | \'1999年\' |
z | 一年中的日子 | 0 到365 |
Z | 时区偏移量,单位为秒。 UTC以西时区的偏移量总是为负数,对于UTC以东时,它们总是为正。 | -43200 到43200 |
自定义过滤器:
因为内置过滤器满足不了我们,所以需要自定义过滤器,只需要遵循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(\',\')方法来获取到多个参数。