如何通过Django类自定义django-filter模板输入控件的渲染样式

你原配置不生效的核心原因是：django_filters.FilterSet的Meta类原生不支持直接通过widgets参数配置控件属性，该写法是Django原生ModelForm的配置规则，不适用于FilterSet。你可以通过以下两种纯Python类层面的方案实现样式自定义，无需修改现有模板代码：

方案1：显式声明过滤器并指定widget #

适合只需给少量筛选字段自定义样式的场景：

import django_filters
from django import forms
from .models import Elemento

class ProductosFilter(django_filters.FilterSet):
    # 对应字段显式声明过滤器，指定widget及属性
    grupo = django_filters.ChoiceFilter(
        widget=forms.Select(attrs={
            'class': 'form-control form-select',
        })
    )
    # 其余字段按需同理配置即可
    estado = django_filters.ChoiceFilter(
        widget=forms.Select(attrs={'class': 'form-control form-select'})
    )
    tipo = django_filters.ChoiceFilter(
        widget=forms.Select(attrs={'class': 'form-control form-select'})
    )

    class Meta:
        model = Elemento
        fields = ('estado','tipo','grupo')

方案2：重写__init__方法批量配置样式 #

适合需要给所有筛选控件统一添加样式的场景，无需逐个声明字段：

import django_filters
from django import forms
from .models import Elemento

class ProductosFilter(django_filters.FilterSet):
    class Meta:
        model = Elemento
        fields = ('estado','tipo','grupo')

    def __init__(self, *args, **kwargs):
        super().__init__(*args, **kwargs)
        # 遍历所有表单字段，统一设置控件属性
        for field in self.form.fields.values():
            # 可根据控件类型差异化配置样式
            if isinstance(field.widget, forms.Select):
                field.widget.attrs.update({'class': 'form-control form-select'})
            else:
                field.widget.attrs.update({'class': 'form-control'})

两种方案都可以直接兼容你现有模板中{{filter.form}}的渲染写法，配置完成后刷新页面即可看到样式生效。

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