一、关于自定义的解释
自定义的一些东西是为了满足系统内置完成不了的一些功能。
二、自定义代码文件夹路径配置(代码布局)
1、第一种方式(某个app特有的自定义代码文件夹)
-
首先在app目录下创建templatetags文件夹
- 之后再到templatetags文件夹下创建python模块(自定义过滤器及标签py文件)
注意:templatetags是一个带有__init__.py的模块的文件夹。
2、第二种方式(定义复用的,即公用的python包文件夹)
-
首先在项目根目录下先创建一个新的python包(可以取名为common)。
-
之后在将common文件夹加入到settings.py文件中的INSTALLED_APP列表中,进行注册。
- 在common里面创建目录templatetags,在目录里面创建自定义过滤器及标签文件。
3、注意事项
(1)templatetags这个目录名字是固定的,而里面的模块名是自定义的。
(2)templates是存放模板的目录,templatetags是存放自定义标签及自定义过滤器的目录。
三、自定义模板过滤器
1、模板过滤器的分析
模板过滤器的本质是一个函数,有一个或者两个参数
;第一个参数是传进来的模板变量,第二个参数是普通的参数、默认的及可以不要的参数
;最终函数返回一个字符串
2、自定义过滤器的注册步骤(实例演示):
-
在teacher/templatetags路径下创建自定义过滤器文件(defined_filters.py)。
- 注册自定义过滤器
django.template.Library.filter()
(1)Library.filter()方法需要两个参数:
a、 过滤器的名称(一个字符串对象)
name:过滤器的名称,是个字符串,可以不写,默认是使用方法名作为过滤器的名称。
b、编译的函数
一个Python函数(不要把函数名写成字符串)----filter_func 定义的过滤器的函数。
(2)没有声明 name 参数,Django将使用函数名作为过滤器的名字。
方法一----------通过调用函数来对自定义过滤器进行注册
方法二--------通过装饰器来对过滤器进行注册
3、使用自定义过滤器
- 在模板中使用自定义的过滤器:
需要使用{% load %}标签将我们的自定义过滤器的模块加载进来。 {% load %} 声明将会载入给定模块名中的标签/过滤器。
4、访问服务器显示web页面