Wagtail开发：能否让ImageChooser仅展示特定尺寸图片？

嘿，这个需求完全能搞定！要让Wagtail的ImageChooser一开始就只展示符合特定尺寸的图片，核心是自定义它的查询集过滤逻辑，我给你拆解成具体步骤：

1. 自定义ImageChooserPanel子类 #

Wagtail的ImageChooserPanel允许我们重写get_chooser_queryset方法，在这里添加尺寸过滤条件。比如你要求图片宽度至少1200px、高度至少600px，代码可以这么写：

from wagtail.images.edit_handlers import ImageChooserPanel

class BrandImageChooserPanel(ImageChooserPanel):
    def get_chooser_queryset(self, request):
        # 先获取默认的图片查询集
        qs = super().get_chooser_queryset(request)
        # 替换成你的具体尺寸规则：这里是宽≥1200px，高≥600px
        return qs.filter(width__gte=1200, height__gte=600)

你可以根据需求调整过滤条件：

• 要精确尺寸就用width=1200, height=600
• 要上限就用width__lte=xxx
• 范围的话可以组合width__gte=xxx, width__lte=yyy

2. 在模型中使用自定义的ChooserPanel #

把原来的ImageChooserPanel替换成我们刚写的自定义面板，比如在你的品牌页面模型里：

from django.db import models
from wagtail.models import Page

class BrandPage(Page):
    brand_image = models.ForeignKey(
        'wagtailimages.Image',
        null=True,
        blank=True,
        on_delete=models.SET_NULL,
        related_name='+',
        help_text="请上传符合要求尺寸的图片，仅符合条件的图片会在选择器中显示"
    )

    content_panels = Page.content_panels + [
        # 用自定义面板替代默认的ImageChooserPanel
        BrandImageChooserPanel('brand_image', heading="品牌图片"),
    ]

3. 进阶：按比例过滤图片（可选） #

如果你的需求是特定宽高比（比如16:9），可以通过annotate计算比例后过滤：

from django.db.models import F, ExpressionWrapper, FloatField
from wagtail.images.edit_handlers import ImageChooserPanel

class RatioImageChooserPanel(ImageChooserPanel):
    def get_chooser_queryset(self, request):
        qs = super().get_chooser_queryset(request)
        # 计算宽高比（保留两位小数）
        qs = qs.annotate(
            aspect_ratio=ExpressionWrapper(F('width') / F('height'), output_field=FloatField())
        )
        # 过滤16:9比例（允许±0.01的误差）
        return qs.filter(aspect_ratio__gte=1.77, aspect_ratio__lte=1.78)

最后别忘了双重保障 #

虽然选择器已经过滤了符合条件的图片，但建议保留之前的clean方法验证逻辑——防止用户通过API、数据库修改等非常规方式上传不符合要求的图片，双重验证更稳妥。

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