Django模板层——三种自定义模板simple_tag、inclusion_tag、filter的用法

2024-04-04 16:36

本文主要是介绍Django模板层——三种自定义模板simple_tag、inclusion_tag、filter的用法,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!

目录

1. 前言

2. 前置操作

3. simple_tag

3.1 注意点

4. inclusion_tag

5. filter

6. 结尾


1. 前言

在前后端不分离的模式中,Django的模板语法尤为重要,我们可以动态传入变量,并在前端HTML中进行展示。在变量展示时,会有一些内置的过滤器和方法,但这远远不能满足我们的需求。因此,在Django模板中,还有三大自定义的常用模板:simple_taginclusion_tagfilter ,能在开发中,为我们省去很多麻烦。

我将通过实际案例的方式,引出自定义模板的用法。

2. 前置操作

  • 注册app

先注册好需要使用的app:

我这里用app01来进行演示

  • 在视图中定义好返回的HTML

  • 创建templatetags文件夹

我们需要先创建templatetags文件夹,并放入我们自定义的模板函数,这样做是为了保证Django能够更好的管理他们,并且在后续引入模块的时候,直接去templatetags中找。

注意:templatetags是需要放在应用程序app下的,Django默认去app下寻找

  • 建立自己的自定义模块

这里的名字可以随意

  • 注册自定义模板标签

实例化Library对象,用于注册自定义模板标签,以至于Django能够使用这些标签

from django.template.library import Libraryregister = Library()

3. simple_tag

simple_tagDjango自定义模板中的一个装饰器,主要用于字符串的处理,可以定义一个接受参数并返回字符串的自定义标签

我们还是从需求出发:

需求:在页面中实时刷新显示当前时间(简单一点,刷新之后,动态显示时间)

我们可以自定义我们的时间格式:

import datetimefrom django.template.library import Libraryregister = Library()@register.simple_tag()
def my_func(format_string):return datetime.datetime.now().strftime(format_string)
{% load test_tag %}
<!DOCTYPE html>
<html lang="en">
<head><meta charset="UTF-8"><title>Title</title>
</head>
<body>
当前日期时间: {% my_func "%Y-%m-%d %H:%M:%S" %}</body>
</html>

最终显示: 

刷新后:

3.1 注意点

如果你在代码执行时,遇到了这个报错:

django.template.exceptions.TemplateSyntaxError: '####' is not a registered tag libr...

并且,你的代码没有任何问题,你只需要重新启动Django程序,清理缓存就好了。

4. inclusion_tag

inclusion_tag主要用于复用模板,如果在多个页面都需要使用同一段HTML代码,这个时候,复用就会使得代码变得更加简洁。

需求:使用列表展示信息

@register.inclusion_tag("user.html")
def my_xo(num):return {"x1": [item for item in num]}

user.html

<ul>{% for item in x1 %}<li>{{ item }}</li>{% endfor %}
</ul>

view.py

def test(request):return render(request, 'test.html', {'num': ['王者荣耀', '原神', '和平精英']})

调用:

{% load test_tag %}
<!DOCTYPE html>
<html lang="en">
<head><meta charset="UTF-8"><title>Title</title>
</head>
<body>
当前日期时间: {% my_func "%Y-%m-%d %H:%M:%S" %}展示列表:
{% my_xo num %}</body>
</html>

结果:

5. filter

Django 模板系统中的一个过滤器,用于在模板中对变量进行简单的处理和过滤。过滤器可以用于修改变量的显示方式、筛选列表、格式化数据等。

需求:页面展示标题,最长10个字,超出打自定义传入的符号

test_tag.py

@register.filter
def my_filter(x1, sign):return x1[:10] + sign

test.html

{% load test_tag %}
<!DOCTYPE html>
<html lang="en">
<head><meta charset="UTF-8"><title>Title</title>
</head>
<body>
当前日期时间: {% my_func "%Y-%m-%d %H:%M:%S" %}展示列表:
{% my_xo num %}标题:
{{ '我爱玩原神,那么,原神启动!'|my_filter:'...' }}</body>
</html>

展示:

6. 结尾

有关Django模板层中三种自定义模板标签就介绍到这里了。

利用这些自定义标签,在我们日后的开发中能省却很多代码量,大多都是重复的。

这会让我们的代码更加具有可复用性。

这篇关于Django模板层——三种自定义模板simple_tag、inclusion_tag、filter的用法的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!



http://www.chinasem.cn/article/876291

相关文章

揭秘Python Socket网络编程的7种硬核用法

《揭秘PythonSocket网络编程的7种硬核用法》Socket不仅能做聊天室,还能干一大堆硬核操作,这篇文章就带大家看看Python网络编程的7种超实用玩法,感兴趣的小伙伴可以跟随小编一起... 目录1.端口扫描器:探测开放端口2.简易 HTTP 服务器:10 秒搭个网页3.局域网游戏:多人联机对战4.

MyBatis 动态 SQL 优化之标签的实战与技巧(常见用法)

《MyBatis动态SQL优化之标签的实战与技巧(常见用法)》本文通过详细的示例和实际应用场景,介绍了如何有效利用这些标签来优化MyBatis配置,提升开发效率,确保SQL的高效执行和安全性,感... 目录动态SQL详解一、动态SQL的核心概念1.1 什么是动态SQL?1.2 动态SQL的优点1.3 动态S

使用Sentinel自定义返回和实现区分来源方式

《使用Sentinel自定义返回和实现区分来源方式》:本文主要介绍使用Sentinel自定义返回和实现区分来源方式,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教... 目录Sentinel自定义返回和实现区分来源1. 自定义错误返回2. 实现区分来源总结Sentinel自定

java之Objects.nonNull用法代码解读

《java之Objects.nonNull用法代码解读》:本文主要介绍java之Objects.nonNull用法代码,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐... 目录Java之Objects.nonwww.chinasem.cnNull用法代码Objects.nonN

如何自定义Nginx JSON日志格式配置

《如何自定义NginxJSON日志格式配置》Nginx作为最流行的Web服务器之一,其灵活的日志配置能力允许我们根据需求定制日志格式,本文将详细介绍如何配置Nginx以JSON格式记录访问日志,这种... 目录前言为什么选择jsON格式日志?配置步骤详解1. 安装Nginx服务2. 自定义JSON日志格式各

JavaScript Array.from及其相关用法详解(示例演示)

《JavaScriptArray.from及其相关用法详解(示例演示)》Array.from方法是ES6引入的一个静态方法,用于从类数组对象或可迭代对象创建一个新的数组实例,本文将详细介绍Array... 目录一、Array.from 方法概述1. 方法介绍2. 示例演示二、结合实际场景的使用1. 初始化二

Django序列化中SerializerMethodField的使用详解

《Django序列化中SerializerMethodField的使用详解》:本文主要介绍Django序列化中SerializerMethodField的使用,具有很好的参考价值,希望对大家有所帮... 目录SerializerMethodField的基本概念使用SerializerMethodField的

Android自定义Scrollbar的两种实现方式

《Android自定义Scrollbar的两种实现方式》本文介绍两种实现自定义滚动条的方法,分别通过ItemDecoration方案和独立View方案实现滚动条定制化,文章通过代码示例讲解的非常详细,... 目录方案一:ItemDecoration实现(推荐用于RecyclerView)实现原理完整代码实现

C语言实现两个变量值交换的三种方式

《C语言实现两个变量值交换的三种方式》两个变量值的交换是编程中最常见的问题之一,以下将介绍三种变量的交换方式,其中第一种方式是最常用也是最实用的,后两种方式一般只在特殊限制下使用,需要的朋友可以参考下... 目录1.使用临时变量(推荐)2.相加和相减的方式(值较大时可能丢失数据)3.按位异或运算1.使用临时

一文带你了解SpringBoot中启动参数的各种用法

《一文带你了解SpringBoot中启动参数的各种用法》在使用SpringBoot开发应用时,我们通常需要根据不同的环境或特定需求调整启动参数,那么,SpringBoot提供了哪些方式来配置这些启动参... 目录一、启动参数的常见传递方式二、通过命令行参数传递启动参数三、使用 application.pro