You need to enable JavaScript to run this app. Django中如何在搜索无匹配结果时展示「未找到内容」提示
优惠活动
大模型
产品
解决方案
定价
更多

Django中如何在搜索无匹配结果时展示「未找到内容」提示

问题原因说明

之前的判断逻辑完全失效的核心是:get_queryset无论返回有数据的查询集、还是空查询集(包括objects.none()),本质都是Django QuerySet对象,永远不会等于None,因此{% if object_list != None %}的判断结果永远为真,else分支永远不会被触发。
另外当前模板的HTML结构存在小问题:把</thead>标签放在了循环内部,实际渲染会出现表格结构错乱,需要把表头部分和循环渲染的表体部分拆分。

可行实现方案

1. 最基础的模板改造

直接通过QuerySet的布尔判断区分是否有结果,空结果时渲染自定义区块即可,不需要修改视图代码:

<!-- 原有卡片头保留不变 -->
<div class="card-header py-3 d-flex flex-row align-items-center justify-content-between">
  <h6 class="m-0 font-weight-bold text-primary">Search Results for: {{ request.GET.q }}</h6>
</div>

<div class="card-body">
  {% if object_list %}
    <!-- 有匹配结果时才渲染完整表格 -->
    <div class="table-responsive">
      <table class="table table-bordered" width="100%" cellspacing="0">
        <!-- 表头部分独立于循环渲染 -->
        <thead>
          <tr>
            <th>优先级</th>
            <!-- 其余表头列按需补充 -->
          </tr>
        </thead>
        <tbody>
          {% for query in object_list %}
          <tr>
            <td>
              {% if query.importance == "H" %}
              <span data-toggle="tooltip" data-placement="top" title="HIGH">
                <i style="color: red" class="fas fa-bookmark"></i>
              </span>
              {% elif query.importance == "M" %}
              <span data-toggle="tooltip" data-placement="top" title="Medium">
                <i style="color: orange" class="fas fa-bookmark"></i>
              </span>
              {% endif %}
            </td>
            <!-- 其余表体列按需补充 -->
          </tr>
          {% endfor %}
        </tbody>
      </table>
    </div>
  {% else %}
    <!-- 空结果时可自由渲染自定义div、表单、按钮等任意内容 -->
    <div class="text-center py-5">
      <h4>未找到相关内容</h4>
      <p class="text-gray-500">可尝试更换搜索关键词,或创建新的任务条目</p>
      <!-- 可嵌入任意自定义表单、跳转按钮 -->
      <a href="#" class="btn btn-primary mt-3">新建任务</a>
    </div>
  {% endif %}
</div>

注:Django中QuerySet对象的布尔值判断会自动检测是否存在查询结果,空QuerySet在{% if %}判断中会直接返回False,无需额外和None做比较。

2. 细分空状态提示(可选优化)

如果需要区分「用户未输入搜索关键词」和「输入关键词但无匹配结果」两种场景,展示不同的提示内容,可以在视图中补充上下文传递:
修改后的views.py代码:

class TaskSearchView(LoginRequiredMixin, ListView):
    template_name = 'task_app/task_search.html'
    model = Task
    # 默认空状态提示
    empty_notice = "请输入搜索关键词查找对应任务"

    def get_queryset(self):
        query = self.request.GET.get('q')
        usr = self.request.user
        if query:
            # 补充括号明确Q对象的组合逻辑,避免运算符优先级导致过滤结果错误
            object_list = self.model.objects.filter(
                Q(title__icontains=query, is_public=True) | 
                Q(title__icontains=query, author=usr) | 
                Q(title__icontains=query, responsable=usr)
            )
            # 有搜索词但无匹配结果时,更新提示内容
            if not object_list.exists():
                self.empty_notice = f"未找到与「{query}」匹配的任务,请尝试更换关键词"
        else:
            object_list = self.model.objects.none()
        return object_list

    def get_context_data(self, **kwargs):
        # 将空状态提示传入模板
        context = super().get_context_data(**kwargs)
        context['empty_notice'] = self.empty_notice
        return context

此时模板的空状态分支可直接调用传入的提示变量:

{% else %}
  <div class="text-center py-5">
    <h4>{{ empty_notice }}</h4>
    <p class="text-gray-500">支持通过任务标题关键词检索公开任务、你负责的任务及你创建的任务</p>
  </div>
{% endif %}

内容的提问来源于stack exchange,提问作者Caio César P. Ricciuti

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.17 07:15:04