我是靠谱客的博主 仁爱冥王星,这篇文章主要介绍详解django中自定义标签和过滤器,现在分享给大家,希望可以做个参考。

想要实现自定义标签和过滤器需要进行准备工作:

准备(必需)工作:

1  在某个app下创建一个名为templatetags(必需,且包名不可变)的包。假设我们在名为polls的app下创建了一个templatetags的包,并在该包下创建了一个名为mytags的文件。那么目录结构看起来应该就像这样:

复制代码
1
2
3
4
5
6
7
polls/ __init__.py models.py templatetags/ __init__.py mytags.py views.py

2  settings文件中的INSTALLD_APPS内必须含有该app。接下来,我们需要确认settings文件中的INSTALLED_APPS变量中已经有了polls

复制代码
1
2
3
4
5
6
7
8
9
INSTALLED_APPS = ( 'django.contrib.admin', 'django.contrib.auth', 'django.contrib.contenttypes', 'django.contrib.sessions', 'django.contrib.messages', 'django.contrib.staticfiles', 'polls', )

3  接下来在mytags文件中写入如下几行

复制代码
1
2
3
from django import template register = template.Library()

4  在模板中使用{% load %} 标签装载自定义标签或者装饰器

复制代码
1
{% load mytags %}

自定义过滤器:

1  自定义过滤器实际上就是写一个函数

2  django会将过滤器前的值传入该函数

3  函数完成后,需要进行登记register

因为第二步django已经帮我们完成,所以我们实际上只需要自己完成第一步和第三步

实例:写一个自动省略多余字符串的过滤器 

1  定义一个  truncate_chars  函数

复制代码
1
2
3
4
5
6
# 若字符串长度大于30,则省略之后的内容,否则原样输出该字符串。参数value就是过滤器前的值 def truncate_chars(value): if value.__len__() > 30: return '%s......'% value[0:30] else: return value

2  register该函数

复制代码
1
2
3
4
5
6
7
# 登记 register.filter('truncate_chars',truncate_chars) def truncate_chars(value): if value.__len__() > 30: return '%s......'% value[0:30] else: return value

Library.filter(name,function,is_safe=False,needs_autoescape=False,excepts_localtime=False)函数默认需要两个参数,name是装饰器的名称(字符串类型),function是函数名。后面三个参数可以参考 官方文档。 我们也可以通过装饰器进行登记

复制代码
1
2
3
4
5
6
@register.filter(name='truncate_filter') def truncate_chars(value): if value.__len__() > 30: return '%s......'% value[0:30] else: return value

如果没有使用name参数,django默认会将函数名作为name参数的值,所以下面的代码和上面的代码作用相同。

复制代码
1
2
3
4
5
6
@register.filter def truncate_chars(value): if value.__len__() > 30: return '%s......'% value[0:30] else: return value

3  测试模板文件内容

复制代码
1
2
3
4
5
6
7
8
9
10
11
{% load mytags %} <!DOCTYPE html> <html lang="en"> <head> <meta charset="UTF-8"> <title>Title</title> </head> <body> {{ 'alskdjasdfasdfasdffasdfasdfasdffasdffasdffasdffasdfasdffasdffalskdjasdfasdfasdffasdfasdfasdffasdffasdffasdffasdfasdffasdff'|truncate_chars }} </body> </html>

4  浏览器显示结果

自定义标签

自定义标签相对于自定义过滤器来说要复杂很多,因为自定义标签可以做任何事情!

自定义标签分为很多类型

1  简单标签  Simple tags

2  内含标签  Inclusion tags

3  分配标签  Assignment tags

一  简单标签

复制代码
1
2
3
4
5
6
7
8
import datetime from django import template register = template.Library() @register.simple_tag def current_time(format_string): return datetime.datetime.now().strftime(format_string)

Library.simple_tag(takes_context=True)  takes_context=True参数可以让我们访问模板的当前环境上下文,即将当前环境上下文中的参数和值作为字典传入函数中的一个名为context的参数

复制代码
1
2
3
4
@register.simple_tag(takes_context=True) def current_time(context, format_string): timezone = context['timezone'] return your_get_current_time_method(timezone, format_string)

当使用take_context=True时,函数的第一个参数必需为context。也可以使用name参数对函数进行重命名。

二  内含标签

这种类型的标签可以被其他模板进行渲染,然后将渲染结果输出

Library.inclusion_tag()支持take_context=True,用法类似Library.simple_tag()

复制代码
1
2
3
4
5
6
7
from django import template register = template.Library() @register.inclusion_tag('result.html') def test(): a=['first','second','third'] return {'choices':a}

result.html 内容

复制代码
1
2
3
4
5
<ul> {% for choice in choices %} <li> {{ choice }} </li> {% endfor %} </ul>

test.html内容

复制代码
1
2
3
4
5
6
7
8
9
10
11
{% load mytags %} <!DOCTYPE html> <html lang="en"> <head> <meta charset="UTF-8"> <title>Title</title> </head> <body> {% test %} </body> </html>

view函数:

复制代码
1
2
def test(request): return render(request,'test.html')

当访问http://127.0.0.1:8000/test/时,浏览器显示:

 

三  分配标签

类似于简单标签,但并不会输出结果,可以使用 as 关键字将结果赋给一个参数。

复制代码
1
2
3
@register.assignment_tag def get_current_time(format_string): return datetime.datetime.now().strftime(format_string)
复制代码
1
2
{% get_current_time "%Y-%m-%d %I:%M %p" as the_time %} <p>The time is {{ the_time }}.</p>

以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持脚本之家。

最后

以上就是仁爱冥王星最近收集整理的关于详解django中自定义标签和过滤器的全部内容,更多相关详解django中自定义标签和过滤器内容请搜索靠谱客的其他文章。

本图文内容来源于网友提供,作为学习参考使用,或来自网络收集整理,版权属于原作者所有。
点赞(136)

评论列表共有 0 条评论

立即
投稿
返回
顶部