详解django中自定义标签和过滤器

发布时间 - 2026-01-11 02:09:38    点击率:

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

准备(必需)工作:

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

polls/
  __init__.py
  models.py
  templatetags/
    __init__.py
    mytags.py
  views.py

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

INSTALLED_APPS = (
  'django.contrib.admin',
  'django.contrib.auth',
  'django.contrib.contenttypes',
  'django.contrib.sessions',
  'django.contrib.messages',
  'django.contrib.staticfiles',
  'polls',
)

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

from django import template

register = template.Library()

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

{% load mytags %}

自定义过滤器:

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

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

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

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

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

1  定义一个  truncate_chars  函数

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

2  register该函数

# 登记
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是函数名。后面三个参数可以参考 官方文档。 我们也可以通过装饰器进行登记

@register.filter(name='truncate_filter')
def truncate_chars(value):
  if value.__len__() > 30:
    return '%s......'% value[0:30]
  else:
    return value

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

@register.filter
def truncate_chars(value):
  if value.__len__() > 30:
    return '%s......'% value[0:30]
  else:
    return value

3  测试模板文件内容

{% 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

一  简单标签

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的参数

@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()

from django import template
register = template.Library()

@register.inclusion_tag('result.html')
def test():
  a=['first','second','third']
  return {'choices':a}

result.html 内容

<ul>
{% for choice in choices %}
  <li> {{ choice }} </li>
{% endfor %}
</ul>

test.html内容

{% load mytags %}
<!DOCTYPE html>
<html lang="en">
<head>
  <meta charset="UTF-8">
  <title>Title</title>
</head>
<body>
{% test %}
</body>
</html>

view函数:

def test(request):
  return render(request,'test.html')

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

 

三  分配标签

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

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

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


# django  # 自定义标签  # 自定义过滤器  # 过滤器  # 在django中使用自定义标签实现分页功能  # Django零基础入门之自定义过滤器及模板中的使用  # Django零基础入门之自定义标签及模板中的使用  # 自定义  # 可以使用  # 会将  # 就像  # 第一个  # 让我们  # 并在  # 可以通过  # 如果没有  # 只需要  # 说要  # 相对于  # 准备工作  # 已经有了  # 类似于  # 第二步  # 创建一个  # 第三步  # 大家多多  # 重命名 


相关栏目: 【 网站优化151355 】 【 网络推广146373 】 【 网络技术251813 】 【 AI营销90571


相关推荐: 深圳网站制作平台,深圳市做网站好的公司有哪些?  JS实现鼠标移上去显示图片或微信二维码  大型企业网站制作流程,做网站需要注册公司吗?  Laravel如何处理和验证JSON类型的数据库字段  敲碗10年!Mac系列传将迎来「触控与联网」双革新  Angular 表单中正确绑定输入值以确保提交与验证正常工作  湖南网站制作公司,湖南上善若水科技有限公司做什么的?  Windows10电脑怎么设置虚拟光驱_Win10右键装载ISO镜像文件  为什么php本地部署后css不生效_静态资源加载失败修复技巧【技巧】  Laravel Seeder怎么填充数据_Laravel数据库填充器的使用方法与技巧  如何用PHP工具快速搭建高效网站?  香港服务器部署网站为何提示未备案?  Thinkphp 中 distinct 的用法解析  HTML5空格和nbsp有啥关系_nbsp的作用及使用场景【说明】  网站制作软件免费下载安装,有哪些免费下载的软件网站?  Laravel怎么配置.env环境变量_Laravel生产环境敏感数据保护与读取【方法】  Laravel如何获取当前登录用户信息_Laravel Auth门面使用与Session用户读取【技巧】  iOS UIView常见属性方法小结  作用域操作符会触发自动加载吗_php类自动加载机制与::调用【教程】  Laravel如何使用Facades(门面)及其工作原理_Laravel门面模式与底层机制  购物网站制作费用多少,开办网上购物网站,需要办理哪些手续?  Android中AutoCompleteTextView自动提示  Laravel如何使用Service Provider注册服务_Laravel服务提供者配置与加载  专业型网站制作公司有哪些,我设计专业的,谁给推荐几个设计师兼职类的网站?  Win11搜索不到蓝牙耳机怎么办 Win11蓝牙驱动更新修复【详解】  ChatGPT常用指令模板大全 新手快速上手的万能Prompt合集  Laravel任务队列怎么用_Laravel Queues异步处理任务提升应用性能  如何快速搭建高效可靠的建站解决方案?  桂林网站制作公司有哪些,桂林马拉松怎么报名?  Laravel如何发送系统通知?(Notification渠道示例)  Laravel表单请求验证类怎么用_Laravel Form Request分离验证逻辑教程  Laravel如何使用Socialite实现第三方登录?(微信/GitHub示例)  如何实现javascript表单验证_正则表达式有哪些实用技巧  Laravel如何连接多个数据库_Laravel多数据库连接配置与切换教程  Laravel如何处理表单验证?(Requests代码示例)  Java类加载基本过程详细介绍  如何用5美元大硬盘VPS安全高效搭建个人网站?  Laravel如何处理文件下载请求?(Response示例)  如何在IIS服务器上快速部署高效网站?  JS中页面与页面之间超链接跳转中文乱码问题的解决办法  小米17系列还有一款新机?主打6.9英寸大直屏和旗舰级影像  Python文件流缓冲机制_IO性能解析【教程】  网站制作壁纸教程视频,电脑壁纸网站?  Laravel如何实现API资源集合?(Resource Collection教程)  用yum安装MySQLdb模块的步骤方法  大同网页,大同瑞慈医院官网?  北京网站制作的公司有哪些,北京白云观官方网站?  百度浏览器如何管理插件 百度浏览器插件管理方法  Laravel如何升级到最新的版本_Laravel版本升级流程与兼容性处理  Laravel怎么调用外部API_Laravel Http Client客户端使用