如何在Django中实现自定义过滤搜索功能？

1. 核心实现思路 #

django-filter 本身支持自定义过滤字段和过滤逻辑，完全可以满足你的需求，不需要修改视图逻辑，只需要调整FilterSet的定义即可。

2. 时间相近匹配实现 #

要实现time字段同时匹配提交值和相近值的需求，可以自定义过滤字段，并且声明对应的过滤处理方法，示例修改后的filters.py代码如下：

import django_filters
from datetime import timedelta
from .models import Lead

class StudentFilter(django_filters.FilterSet):
    # 自定义time过滤字段，可直接声明不需要对应模型实际字段
    search_time = django_filters.DateTimeFilter(
        label="搜索时间（匹配前后15分钟数据）",
        method="filter_near_time" # 绑定自定义过滤方法
    )

    class Meta:
        model = Lead
        fields = {
            'first_name': ['icontains'],
            'email': ['exact'],
        }

    def filter_near_time(self, queryset, name, value):
        # 这里可对提交的value做任意查询、计算、修改，对应你需要的类似form_valid的处理能力
        # 示例：筛选time字段在提交时间前后15分钟内的实例
        start_time = value - timedelta(minutes=15)
        end_time = value + timedelta(minutes=15)
        return queryset.filter(time__range=(start_time, end_time))

你可以在自定义过滤方法中任意调整逻辑，比如修改时间匹配范围、关联其他表做过滤、转换提交值的格式等，最终返回过滤后的查询集即可。

3. 非模型对应字段的过滤实现 #

如果需要创建完全不对应模型实际字段的过滤项，直接在FilterSet里声明对应字段和处理方法即可，比如添加按年龄段筛选的功能，模型里只有birth_date字段没有年龄字段，实现示例如下：

class StudentFilter(django_filters.FilterSet):
    # 原有字段省略
    age_group = django_filters.ChoiceFilter(
        label="年龄段",
        choices=(
            ('10-18', '10-18岁'),
            ('19-25', '19-25岁'),
            ('26+', '26岁以上'),
        ),
        method="filter_age_group"
    )

    def filter_age_group(self, queryset, name, value):
        # 根据提交的年龄段计算对应的出生日期范围
        from datetime import date
        today = date.today()
        if value == '10-18':
            min_birth = today.replace(year=today.year - 18)
            max_birth = today.replace(year=today.year - 10)
        elif value == '19-25':
            min_birth = today.replace(year=today.year - 25)
            max_birth = today.replace(year=today.year - 19)
        else:
            max_birth = today.replace(year=today.year - 26)
            min_birth = date.min
        return queryset.filter(birth_date__range=(min_birth, max_birth))

4. 模板使用 #

自定义的过滤字段和原生字段使用方式完全一致，直接渲染过滤表单即可，不需要修改你现有StudentListView的代码：

<form method="get">
    {{ filter.form.as_p }}
    <button type="submit">搜索</button>
</form>

{% for lead in leads %}
<!-- 渲染列表内容 -->
{% endfor %}

内容的提问来源于stack exchange，提问作者coderDcoder