Django函数视图中筛选与分页共存时的状态保持问题

问题根源 #

分页链接没有携带当前的筛选参数（比如name），切换页码时只会发送page参数，导致视图无法获取之前的筛选条件，从而回到未筛选状态。同时表单输入框的回显也有问题，因为模板中使用的name变量没有被传入上下文。

具体修复步骤 #

1. 修正视图层（views.py） #

• 将筛选参数传入模板上下文，方便表单回显和分页链接使用
• 用render函数替代loader.get_template，它会自动把request对象传入上下文，简化后续模板处理

修改后的views.py：

from django.shortcuts import render
from django.core.paginator import Paginator
from .models import Player

def GetPlayers(request):
    players = Player.objects.all().values()
    
    # 获取并处理筛选参数
    filter_name = request.GET.get('name', '')
    if filter_name.strip():
        players = players.filter(name__icontains=filter_name)

    # 分页处理
    page_num = request.GET.get('page', 1)
    paginator = Paginator(players, 2)
    page_obj = paginator.get_page(page_num)
    
    # 将筛选参数传入上下文
    context = {
        'page_obj': page_obj,
        'filter_name': filter_name,
    }
    return render(request, 'players.html', context)

2. 修正模板层（players.html） #

2.1 修复表单输入框回显

把模板中判断输入框值的变量改成上下文里的filter_name：

<input type="text" class="form-control" placeholder="name" name="name" {% if filter_name %}value="{{ filter_name }}"{% endif %}>

2.2 修复分页链接（修改pagination.html）

需要在分页的每个页码链接中，保留当前所有的查询参数（除了page本身），这样切换页码时筛选条件不会丢失。

假设你的pagination.html原本是基础分页模板，修改后如下：

<div class="pagination">
    <span class="step-links">
        {% if page_obj.has_previous %}
            {% with query_params=request.GET %}
                <a href="?{% if query_params %}{{ query_params.urlencode }}&{% endif %}page=1">&laquo; first</a>
                <a href="?{% if query_params %}{{ query_params.urlencode }}&{% endif %}page={{ page_obj.previous_page_number }}">previous</a>
            {% endwith %}
        {% endif %}

        <span class="current">
            Page {{ page_obj.number }} of {{ page_obj.paginator.num_pages }}.
        </span>

        {% if page_obj.has_next %}
            {% with query_params=request.GET %}
                <a href="?{% if query_params %}{{ query_params.urlencode }}&{% endif %}page={{ page_obj.next_page_number }}">next</a>
                <a href="?{% if query_params %}{{ query_params.urlencode }}&{% endif %}page={{ page_obj.paginator.num_pages }}">last &raquo;</a>
            {% endwith %}
        {% endif %}
    </span>
</div>

这种写法会自动带上当前所有的查询参数，再追加新的page参数，即使原有参数里有page，新的page值也会覆盖掉旧的，不影响功能。

3. 确保模板能访问request对象 #

如果使用render函数，默认会把request传入上下文；若配置有问题，检查settings.py中的TEMPLATES配置，确保context_processors包含以下项：

TEMPLATES = [
    {
        # 其他配置项
        'OPTIONS': {
            'context_processors': [
                # 其他处理器
                'django.template.context_processors.request',  # 确保此行存在
            ],
        },
    },
]

验证效果 #

现在筛选名称包含"J"的玩家后，点击分页链接，URL里会同时包含name=J和page=2这类参数，视图能正确获取筛选条件，分页时就不会重置筛选状态，表单输入框也会保留之前的筛选值。

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