模版之过滤器

2018-12-10 本文已影响13人乔治大叔

语法：

`default`

如果一个变量是false或者为空，使用给定的默认值。否则，使用变量的值。例如：

{{ value|default:``"nothing" }}

length

返回值的长度。它对字符串和列表都起作用。例如：

{{ value|length }}

如果 value 是 ['a', 'b', 'c', 'd']，那么输出是 4。

`filesizeformat`

将值格式化为一个 “人类可读的” 文件尺寸（例如 '13 KB', '4.1 MB', '102 bytes', 等等）。例如：

{{ value|filesizeformat }}

如果 value 是 123456789，输出将会是 117.7 MB。

date

如果 value=datetime.datetime.now()

{{ value|date:``"Y-m-d" }}

slice

如果 value="hello world"

{{ value|``slice``:``"2:-1" }}

truncatechars

如果字符串字符多于指定的字符数量，那么会被截断。截断的字符串将以可翻译的省略号序列（“...”）结尾。

参数：要截断的字符数

例如：

{{ value|truncatechars:``9 }}

safe

Django的模板中会对HTML标签和JS等语法标签进行自动转义，原因显而易见，这样是为了安全。但是有的时候我们可能不希望这些HTML元素被转义，比如我们做一个内容管理系统，后台添加的文章中是经过修饰的，这些修饰可能是通过一个类似于FCKeditor编辑加注了HTML修饰符的文本，如果自动转义的话显示的就是保护HTML标签的源文件。为了在Django中关闭HTML的自动转义有两种方式，如果是一个单独的变量我们可以通过过滤器“|safe”的方式告诉Django这段代码是安全的不必转义。比如：

value``=``"<a href="``">点击</a>"

其它过滤器（了解）

过滤器      描述                   示例
upper       以大写方式输出         {{ user.name | upper }}

add         给value加上一个数值    {{ user.age | add:”5” }}

addslashes  单引号加上转义号     

capfirst    第一个字母大写         {{ ‘good’| capfirst }} 返回”Good”

center      输出指定长度的字符串
                  ，把变量居中     {{ “abcd”| center:”50” }}

cut         删除指定字符串         {{ “You are not a Englishman” | cut:”not” }}

date        格式化日期            {{create_time|date:'Y-m-d'}}

default     如果值不存在，
            则使用默认值代替        {{ value | default:”(N/A)” }}
 
dictsort    按某字段排序，变量
            必须是一个dictionary   {% for moment in moments | dictsort:”id” %}

dictsortreversed    按某字段倒序排序，变量必须是dictionary
     
divisibleby 判断是否可以被数字整除     {{ 224 | divisibleby:2 }}  返回 True

escape      按HTML转义，比如将”<”转换为”&lt”   

filesizeformat  增加数字的可读性，转换结果
                为13KB,89MB,3Bytes等   {{ 1024 | filesizeformat }} 返回 1.0KB

first       返回列表的第1个元素，变量必须是一个列表     
floatformat 转换为指定精度的小数，
            默认保留1位小数              {{ 3.1415926 | floatformat:3 }} 返回 3.142  四舍五入

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

join        用指定分隔符连接列表           {{ [‘abc’,’45’] | join:’*’ }} 返回 abc*45

length      返回列表中元素的个数或字符串长度     

length_is   检查列表，字符串长度是否符合指定的值  {{ ‘hello’| length_is:’3’ }}

linebreaks  用<p>或<br>标签包裹变量 {{ “Hi\n\nDavid”|linebreaks }} 返回<p>Hi</p><p>David</p>

linebreaksbr    用<br/>标签代替换行符    

linenumbers 为变量中的每一行加上行号     

ljust   输出指定长度的字符串，变量左对齐    {{‘ab’|ljust:5}}返回 ‘ab   ’
lower   字符串变小写   

make_list   将字符串转换为列表    

pluralize   根据数字确定是否输出英文复数符号     

random  返回列表的随机一项    

removetags  删除字符串中指定的HTML标记 {{value | removetags: “h1 h2”}}

rjust   输出指定长度的字符串，变量右对齐     

slice   切片操作， 返回列表  {{[3,9,1] | slice:’:2’}} 返回 [3,9]

{{ 'asdikfjhihgie' | slice:':5' }} 返回 ‘asdik’

slugify 在字符串中留下减号和下划线，其它符号删除，空格用减号替换