Django模板系统-内置和自定义Filters

django模板中最常用的两种特殊符号是 {{ }} 用来表示变量和 {% %} 用来表示逻辑相关的操作

变量

{{ 变量名 }} ，由字母数字下划线组成而.在模板语言中有特殊含义，用来获取对象相应的属性值

【举例】

在view中进行定义

 def jjzz(request):

    l = [1,2,3]

    d = {"name":"jjzz"}

 

    class Hero(object):

        def __init__(self,name,age):

            self.name = name

            self.age = age

 

        def attack(self):

            return f"{self.name} is attacking ..."

 

    gailun = Hero(name='gailun',age=23)

    zhaoxin = Hero(name='zhaoxin',age=24)

    nvjing  = Hero(name="kaiselin",age=22)

 

    hero_list = [gailun,zhaoxin,nvjing]

 

    return render(request,"jjzz.html",{"l":l,"d":d,"hero_list":hero_list})中HTML支持的写法

HTML中的基础用法

 <body>

 

 {# 获取列表l中的元素 #}

 <p>第一个元素：{{ l.0 }}</p>

 <p>第三个元素：{{ l.2 }}</p>

 

 {# 获取字典d中的key #}

 <p>获取d中的name：{{ d.name }}</p>

 

 {# 获取Hero对象的name属性 #}

 <p>{{ hero_list.0.name }}</p>

 

 {# 使用 . 只能调用不带参数的方法#}

 <p>{{ hero_list.1.attack }}</p>

 

 </body>

【注意】

当模板系统遇到.时，会按照如下的顺序去查询：

在字典中查询
属性或者方法
数字索引

内置Filters

过滤器，用来修饰变量的显示结果

语法 {{ 变量名|过滤器名:参数 }} 注意：两边不能有空格，过滤器与给过滤器的参数是一个整体，而且过滤器只能有一个参数

default

定义变量的默认值，在没有传递变量或者参数没有定义（不存在或者为空）时，使用默认值

{{ value|default_name:"nothing"}}  # 如果value值没有没传的话就显示nothing

 

 源码解释：

 @register.filter(is_safe=False)

 def default(value, arg):

    """If value is unavailable, use given default."""

    return value or arg

【注意】在settings中的TEMPLATES的OPTIONS可以增加一个选项：string_if_invalid：'找不到'，可以替代default的的作用,优先级高于直接设置default。

default_if_none

使用形式： {{ value | default_if_none:"nothing" }} ，

意义：如果value是None，那么输出将是nothing.

源码解释

 @register.filter(is_safe=False)

 def default_if_none(value, arg):

    """If value is None, use given default."""

    if value is None:

        return arg

    return value

【与default的区别】

None：不存在即为空，''，None

unavailable：None，False，[]，{}，''等都可以算是不可用

符号	defaul:"noting"	default_if_none:"noting"
{}	noting	{}
""	noting	noting
None	noting	noting
[]	noting	[]
False	noting	False

filesizeformat

将值转换成便于用户可读的方式。例如：1.1KB，1.1MB，1.1GB

 {{ value|filesizeformat }}   # 比如变量value的值为100000，显示为97.7 KB

add

给变量加参数

 {{ value|add:"2" }}  # value是数字4，则输出结果为6。

 {{ l1|add:l2 }}  # 如果l1是 [1,2,3] ，l2是 [4,5,6] ，那输出结果是 [1,2,3,4,5,6]

lower

 {{ value|lower }}  # 变小写，还能给布尔值变大小写呢

upper

 {{ value|upper}}  # 变大写

title

 {{ value|title }}  # 单词首字母大写

ljust

 "{{ value|ljust:"10" }}"  # 左对齐

rjust

 "{{ value|rjust:"10" }}"  # 右对齐

center

 "{{ value|center:"15" }}"  # 居中

length

 {{ value|length }}  # 返回value的长度，如 value=['a', 'b', 'c', 'd']的话，就显示4

slice

 {{value|slice:"2:-1"}}  # 切片

first

 {{ value|first }}  # 取第一个元素

last

 {{ value|last }}  # 去最后一个元素

join

 {{ value|join:" // " }}  # 使用字符串拼接列表，功能等同于python中的str.join(list)

truncatechars

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

参数：截断的字符数，

 {{ value|truncatechars:9}}  # 截断9个字符

truncatewords

将字符串转换为省略表达方式，以空格计数单词

 {{ value|truncatewords:9}}  # 阶段9个单词

date

 {{ value|date:"Y-m-d H:i:s"}}  # 日期格式化

可格式化输出的字符

也可以在settings中进行日期格式的定义

 USE_L10N = False

 

 DATETIME_FORMAT = 'Y-m-d H:i:s'

 DATE_FORMAT = 'Y-m-d'

 TIME_FORMAT = 'H:i:s'

字典拆包

 {{  dic.key  }}

 

 {{  dic.keys  }}

 

 {{  dic.values  }}

 

 {{  dic.items}}

 

 【注意】Django的模板语言中属性的优先级大于方法

 例如dic = {"name":"jjzz", "items": "100"}

 

 在模板中执行{{ dic.items }}

 

 显示100

safe

通常情况下，django模板会对HTML标签和JS语法进行自动转义，就是将包含的html标签输出，而不被解释执行，原因是当显示用户提交字符串时，可能包含一些攻击性的代码，如js脚本。例如<会转换为&lt，但是有些时候我们不希望这些元素被HTML转义，那么这是就需要safe过滤器来告诉django这段代码是安全的，不需要转义。

 {{ value|safe}}

【举例】

views中设置

 link = '<a href="https://cn.bing.com">这是bing搜索</a>'

 return(request,"jjzz.html",{"link":link})

HTML模板中设置

 <p>{{ link }}</p>

 <p>{{ link|safe }}</p>

显示

还可以在views中在向模板传递数据前使用mark_safe来进行防转义设置

 from django.utils.safestring import mark_safe

 

 a_link= mark_safe('<a href="http://www.baidu.com">跳转</a>')

自定义Filter

自定义的过滤器知识带一个或者两个参数的python函数

定义

在app下创建一个名为templatetags的python包，确保该app已经在settings.py中INSTALLED_APPS注册了。
在包内创建py文件 — > 自定义 jjzz.py

在py文件中写入：

 from django import template

 register = template.Library()  # register不能变

定义函数 + 加装饰

 from django.utils.safestring import mark_safe

 

 @register.filter

 def new_safe(value, arg=None):  # arg 最多有一个

     return mark_safe(value)

在模板中使用：

 {% load jjzz %}

 {{ '<a href="https://cn.bing.com">这是bing搜索</a>'|new_safe }}

Template模板语法