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
相关产品推荐
相关产品推荐

