Django内置过滤器列表与自定义simple_tag及filter实现指南

Django 内置过滤器汇总

Django 提供了丰富的内置模板过滤器，用于在模板中对变量进行格式化处理。

常用内置过滤器示例

自定义模板标签开发

除了内置过滤器，开发者还可以根据需求编写自定义过滤器。

首先，需要在应用目录下创建一个名为 templatetags 的 Python 包。

接着，在该包下创建一个 Python 文件，文件名可以任意指定，例如 my_tags.py。

使用 @register.simple_tag 装饰器定义的标签称为 simple_tag。需要注意的是，simple_tag 不能在模板的 if 判断语句中直接使用。

from django import template
from django.utils.html import format_html
import datetime

register = template.Library()

@register.simple_tag
def page_cut(current_page, loop_page):
 #分页： 固定显示前后5页
 differ = abs(current_page - loop_page)
 if differ < 5:
  li = '''<li class=""><a href="?page=%s" rel="external nofollow" >%s<span class="sr-only">(current)</span></a></li>''' % (loop_page, loop_page)
  return format_html(li)
 else:
  #这里一定要返回一个空字符串，否则在前端会显示一系列的None
  return ''

若需要在模板中进行逻辑判断或更复杂的处理，可以自定义过滤器函数，使用 @register.filter 装饰器。

之所以需要自定义过滤器，正是因为 simple_tag 存在不能在 if 语句中使用的限制。

自定义过滤器函数最多接受两个参数：第一个是变量本身的值，第二个是可选的选项值。

from django import template
from django.utils.html import format_html
import datetime

register = template.Library()

@register.filter
def time_color(exp_date):
 #给一个月内到期的html标签加上class属性
 startdate = datetime.datetime.now().date()
 enddate = startdate + datetime.timedelta(30)
 if (enddate - exp_date).days > 0 and (enddate - exp_date).days <= 30:
  td = '''<td class="%s">%s</td>''' % ('exp_date', exp_date)
  return format_html(td)
 elif (enddate - exp_date).days > 30:
  td = '''<td class="outof">%s</td>''' % (exp_date)
  return format_html(td)
 else:
  td = '''<td>%s</td>''' % (exp_date)
  return format_html(td)

模板中的引用与使用

第二步是在 HTML 模板中引用自定义标签或过滤器。

在模板文件的开头，必须使用 {% load %} 标签导入刚才创建的 Python 文件。

{% load my_page %}

导入后，即可在模板中像使用内置过滤器一样使用自定义功能。

<tbody>
  {% for project in projects_list %}
  <tr>
   <td><a href="{% url 'projects_detail' project.id %}" rel="external nofollow" >{{ project.com_name }}</a></td>
   <td>{{ project.name}}</td>
   <td>{{ project.domain }}</td>
   <td>{{ project.get_status_display }}</td>
   {{ project.exp_date|time_color }}
   <td>{{ project.ftp }}</td>
  </tr>
  {% endfor %}
 </tbody>

以上内容涵盖了 Django 过滤器的基本用法及自定义开发的完整流程，希望对您的开发工作有所帮助。