Python Django模板过滤器与自定义实现详解

Nora

发布时间：2026-10-13 | 2人浏览过

原创

本文详细介绍Django模板中内置过滤器的使用方法，包括date、length和default等常见过滤器的语法与示例。同时深入讲解如何创建自定义模板过滤器，通过Library类注册函数，实现参数传递与逻辑处理，并提供完整的代码示例，帮助开发者灵活扩展模板功能。

本文通过具体实例，详细解析Python Django框架中模板过滤器的使用机制以及自定义过滤器的开发方法，旨在为读者提供实用的参考代码与操作指南。

内置模板过滤器使用

模板过滤器

在Django模板系统中，过滤器的主要作用是对模板变量的值进行特定操作或转换，以便更灵活地展示数据。

date过滤器用于调整日期对象的显示格式，允许开发者自定义输出的时间样式。

length过滤器用于计算字符串或列表的长度，返回其包含的元素个数。

default过滤器用于为模板变量设置默认值，当变量为空或未定义时，将显示指定的默认内容。

过滤器的标准调用格式为：模板变量名后接竖线符号“|”，随后跟上过滤器名称，若需传递参数，则在过滤器名后加冒号“:”及具体参数值。

自定义过滤器开发

自定义过滤器

编写自定义过滤器函数时，该函数至少需要接收一个参数（即被过滤的模板变量），最多可接收两个参数（第二个为额外传递的参数）。

以下是一个简单的自定义过滤器示例，展示如何定义基础逻辑。


{{ book.btitle|length }} # 返回字符串或列表的长度

{{ book.bpub_date|date:'Y年-m月-d日' }} # 格式化日期格式

{{ content|default:'hello' }} # 为不存在的变量指定默认值。

自定义模板过滤器

在Django应用中，自定义过滤器代码应存放于应用目录下的templatetags文件夹中，文件名固定为filters.py（注意templatetags目录名不可更改）：


# 自定义过滤器
# 过滤器其实就是python函数
from django.template import Library
# 创建一个Library类的对象
register = Library()
# 自定义的过滤器函数，至少有一个参数，最多两个。(第一个参数就是要过滤的模板变量)
@register.filter
def mod(num):
  '''判断num是否为偶数'''
  return num%2 == 0
@register.filter
def mod_val(num, val):
  '''判断num是否能被val整除'''
  return num%val == 0

在HTML模板文件demo.html中，可以通过load标签加载自定义过滤器并调用：


<!DOCTYPE html>
<html lang="en">
{% load filters %} {# load标签加载自定义过滤器的py文件。和templatetags/filters.py 的py文件名一致。 #}
<head>
  <meta charset="UTF-8">
  <title>模板过滤器</title>
</head>
<body>
<ul>
  {# {% if book.id|mod %}#}  {# 使用自定义的过滤器。需要先load自定义过滤器的py文件 #}
  {% if book.id|mod_val:3 %}  {# 使用自定义的过滤器 #}
    。。。
  {% else %}
    。。。
  {% endif %}
</ul>
</body>
</html>

希望上述关于Django框架下Python程序设计的模板过滤器内容，能对各位开发者的项目实践提供有效帮助。