Django技术问题：如何从Queryset在ListView中显示缩略图

嘿，看了你这段代码，发现你离实现目标只差几步啦！首先有个小疏漏：你在get_context_data里获取了perkz这个包含图片信息的QuerySet，但没把它添加到上下文里，模板根本拿不到这些数据。下面我帮你一步步完善，搞定缩略图展示的需求。

第一步：补全View层代码，把数据传到模板 #

先把你的PersoListView代码补全，确保图片数据能顺利传到模板：

from django.views.generic import ListView
from .models import File  # 记得导入你的File模型

class PersoListView(ListView):
    template_name = 'sconsult/search.html'
    context_object_name = 'search_list'

    def get_context_data(self, **kwargs):
        get_image = self.request.GET.get('q')
        # 调用父类方法获取基础上下文
        context = super().get_context_data(**kwargs)
        
        # 优化查询：明确指定select_related的关联字段，提升性能
        perkz = File.objects.select_related('filedoc').filter(
            citid__persoid=get_image, 
            filedoc__page='1', 
            filedoc__docid='2'
        ).values(
            'filedoc__docimage', 
            'filedoc__docid', 
            'filedesc'
        )
        
        # 关键步骤：把图片数据加入上下文，模板里就能用`thumbnails`变量调用了
        context['thumbnails'] = perkz
        return context

第二步：模板层渲染缩略图 #

接下来在sconsult/search.html里，遍历我们传到模板的thumbnails列表，渲染每个缩略图。这里分两种情况处理：

情况1：图片存在Media目录下（推荐用ImageField存储） #

如果你的filedoc__docimage是用ImageField存在Media目录的，先确保你已经在项目配置里设置好了MEDIA_ROOT和MEDIA_URL，并且在根urls.py里配置了Media路径的访问路由：

# 根urls.py
from django.conf import settings
from django.conf.urls.static import static

urlpatterns = [
    # 你的其他路由配置
] + static(settings.MEDIA_URL, document_root=settings.MEDIA_ROOT)

然后模板里这样写：

{% extends 'base.html' %}  <!-- 替换成你的基础模板 -->

{% block content %}
    <h2>搜索结果缩略图</h2>
    <div class="thumbnail-container">
        {% for item in thumbnails %}
            <div class="thumbnail-card">
                <p class="thumbnail-desc">{{ item.filedesc }}</p>
                <!-- 渲染缩略图，用MEDIA_URL拼接图片路径 -->
                <img 
                    src="{{ MEDIA_URL }}{{ item.filedoc__docimage }}" 
                    alt="{{ item.filedesc }}" 
                    class="thumbnail-img"
                >
            </div>
        {% empty %}
            <p>没有找到匹配的缩略图哦</p>
        {% endfor %}
    </div>
{% endblock %}

情况2：图片存在Static目录下 #

如果图片是放在Static目录的静态资源，就把MEDIA_URL换成STATIC_URL即可：

<img 
    src="{{ STATIC_URL }}{{ item.filedoc__docimage }}" 
    alt="{{ item.filedesc }}" 
    class="thumbnail-img"
>

可选优化：生成自定义尺寸的缩略图 #

如果你的原图太大，需要生成固定尺寸的缩略图，可以在Filedoc模型里加一个方法来处理：

from django.db import models
from PIL import Image
import os
from django.conf import settings

class Filedoc(models.Model):
    docimage = models.ImageField(upload_to='documents/')
    # 你的其他字段...

    def get_thumbnail_url(self):
        # 定义缩略图存储路径：原图片目录下的thumb子文件夹
        base_path, filename = os.path.split(self.docimage.path)
        thumb_dir = os.path.join(base_path, 'thumb')
        # 确保目录存在
        os.makedirs(thumb_dir, exist_ok=True)
        thumb_file_path = os.path.join(thumb_dir, filename)

        # 如果缩略图还没生成，就用PIL生成
        if not os.path.exists(thumb_file_path):
            with Image.open(self.docimage.path) as img:
                # 设置缩略图尺寸，这里是150x150
                img.thumbnail((150, 150))
                img.save(thumb_file_path)
        
        # 返回缩略图的URL
        return f"{settings.MEDIA_URL}documents/thumb/{filename}"

然后View里就不用values()了，直接获取模型对象：

perkz = File.objects.select_related('filedoc').filter(
    citid__persoid=get_image, 
    filedoc__page='1', 
    filedoc__docid='2'
)
context['thumbnails'] = perkz

模板里调用模型方法：

<img 
    src="{{ item.filedoc.get_thumbnail_url }}" 
    alt="{{ item.filedesc }}" 
    class="thumbnail-img"
>

最后给缩略图加个简单的CSS样式，让展示更美观：

.thumbnail-container {
    display: grid;
    grid-template-columns: repeat(auto-fill, minmax(160px, 1fr));
    gap: 1.5rem;
    margin-top: 1rem;
}
.thumbnail-card {
    border: 1px solid #eee;
    border-radius: 6px;
    padding: 0.5rem;
    text-align: center;
}
.thumbnail-img {
    width: 100%;
    height: 130px;
    object-fit: cover;
    border-radius: 4px;
}
.thumbnail-desc {
    margin: 0.5rem 0 0;
    font-size: 0.9rem;
    color: #333;
}

这样就能完美实现从QuerySet获取数据并在ListView里展示缩略图啦！

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