Django ModelForm如何展示多对多关联模型的额外字段信息

问题原因 #

你遍历event_form.groups时拿到的是每个选项的BoundWidget渲染实例，不是UserGroup模型对象，所以无法直接访问weight、hidden这类模型属性。以下是两种纯Django原生实现方案，无需依赖JS：

方案1：直接在模板手动渲染（无需改后端代码，最简便） #

直接访问表单字段绑定的queryset和选中值，手动渲染复选框，原表单的校验、保存逻辑完全不受影响：

<ul>
{% for group in event_form.groups.field.queryset %}
<li>
  <input type="checkbox" 
         name="{{ event_form.groups.name }}" 
         value="{{ group.id }}"
         {% if group.id in event_form.groups.value %}checked{% endif %}
         id="id_{{ event_form.groups.name }}_{{ forloop.counter0 }}">
  <label for="id_{{ event_form.groups.name }}_{{ forloop.counter0 }}">
    {{ group.group_name }} （权重：{{ group.weight }}，是否隐藏：{{ group.hidden }}，成员数：{{ group.users.count }}）
  </label>
</li>
{% endfor %}
</ul>

方案2：自定义Widget（适合多场景复用） #

如果需要在多个地方用到带额外信息的用户组选择框，可以自定义CheckboxSelectMultiple组件，把模型属性注入到选项上下文：

1. 定义自定义Widget

from django.forms.widgets import CheckboxSelectMultiple
from .models import UserGroup

class UserGroupCheckboxSelectMultiple(CheckboxSelectMultiple):
    def create_option(self, name, value, label, selected, index, subindex=None, attrs=None):
        option = super().create_option(name, value, label, selected, index, subindex, attrs)
        # 注入UserGroup额外属性
        group = UserGroup.objects.get(id=value)
        option['weight'] = group.weight
        option['hidden'] = group.hidden
        option['nb_users'] = group.users.count()
        return option

2. 表单替换Widget

class EventDetail(forms.ModelForm):
    groups = forms.ModelMultipleChoiceField(
        label = "Liste des groupes",
        queryset = None,
        widget = UserGroupCheckboxSelectMultiple, # 替换为自定义组件
        required = False
        )
    # 其余代码保持不变

3. 模板直接使用注入的属性

{% for grp in event_form.groups %}
<li>
  {{ grp.tag }} {{ grp.choice_label }}
  （权重：{{ grp.data.weight }}，是否隐藏：{{ grp.data.hidden }}，成员数：{{ grp.data.nb_users }}）
</li>
{% endfor %}

不推荐修改__str__方法实现该需求，该方法是全局生效的，会影响所有用到UserGroup字符串展示的场景，容易引发其他业务逻辑异常。

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