ModelForm 上的 Django 和字段集

Question

我知道您可以在 django 中为管理助手指定字段集。 但是，我找不到任何对 ModelForms 有用的东西。 只是一些我无法使用的补丁。 我错过了什么吗？ 有没有一种方法可以实现类似字段集的功能，而无需在适当的标签中手动写出模板上的每个字段。

理想情况下，我想迭代一组 BoundFields。 但是，在 ModelForm: 末尾执行类似的操作

    fieldsets = []
    fieldsets.append(('Personal Information',
                      [username,password,password2,first_name,last_name,email]),) # add a 2 element tuple of string and list of fields
    fieldsets.append(('Terms & Conditions',
                      [acceptterms,acceptprivacy]),) # add a 2 element tuple of string and list of fields

会失败，因为我的数据结构中包含的项目是原始字段，而不是 BoundFields。 看起来 BoundFields 是动态生成的......这让我很难过。 我可以创建自己的 forms.Form 子类，其中包含字段集的概念（即使是一个不向后兼容的粗略的子类......这仅适用于我自己的项目），如果是这样，您能给出任何指针吗？ 我不想弄乱 django 代码。

Answer 1

我认为 此片段 正是您想要的。 它为您提供了一个 Form 子类，允许您以声明方式将表单细分为字段集并在模板中迭代它们。

更新：该片段已成为 django-form-utils 的一部分

Answer 2

模型表单中的字段集仍处于“设计”阶段。 Django trac 中有一张ticket，活动量较低。

这是我在不久的将来有兴趣研究自己的事情，但由于我还没有这样做，所以我能提供的最好的就是这些片段：

• 表单分割/字段集模板标签
• 分段表单
• 表单在字段集中分割

编辑： 我刚刚再次注意到这个问题，我意识到需要进行编辑来指出 Carl 的项目 django-form-utils其中包含一个 BetterForm 类，该类可以包含字段集。 如果您喜欢这个项目，请为他的下面的答案+1 :)

Answer 3

您可以做的一件事是将逻辑字段集分解为单独的模型表单类。

class PersonalInfoForm (forms.ModelForm):
    class Meta:
        model=MyModel
        fields=('field1', 'field2', ...)

class TermsForm (forms.ModelForm):
    class Meta:
        model=MyModel
        fields=('fieldX', 'fieldY', ...)

将它们通过不同的变量传递给模板并分解表单集：

<form ...>
   <fieldset><legend>Personal Information</legend>
       {{ personal_info_form }}
   </fieldset>
   <fieldset><legend>Terms and Conditions</legend>
       {{ terms_form }}
   </fieldset>
</form>

从这个意义上说，每个表单类只是实际 HTML 表单的一个片段。

当您在表单上调用 save 时，它​​会带来一定的复杂性。 您可能需要传递 commit=False ，然后合并生成的对象。 或者完全避免使用 ModelForm.save 并使用“cleaned_data”手动填充模型对象

Answer 4

Daniel Greenfeld 的 django-uni-form 通过 Layout 辅助类解决了这个问题。 我现在正在尝试，它对我来说看起来很干净。

统一助手可以使用布局对象。 布局可以由字段集、行、列、HTML 和字段组成。

我最初选择 Django-uni-form 是因为它符合 第 508 条。

Answer 5

您可以使用此包：https://pypi.org/project/django-forms-fieldset/

pip install django-forms-fieldset

将 forms_fieldset 添加到您的 INSTALLED_APPS 设置中，如下所示：

INSTALLED_APPS = [
    ...
    'forms_fieldset',
]

在表单中添加 fieldsets

from django.forms import ModelForm

from .models import Student

class StudentForm(ModelForm):
    fieldsets = [
        ("Student Information", {'fields': [
            ('first_name', 'last_name'),
            ('email', 'adress'),
        ]}),
        ("Parent Information", {'fields': [
            'mother_name',
            'father_name',
        ]}),
    ]
    class Meta:
        model = Student
        fields = '__all__'

视图中

def home(request):
    form = StudentForm()
    if request.method == 'POST':
        form = Form(request.POST, request.FILES)
        #save...
    context = {
        'form': form,
    }
    return render(request, 'home.html', context)

在您的模板

{% load forms_fieldset static %}
<link rel="stylesheet" type="text/css" href="{% static 'forms_fieldset/css/main.css' %}">

<form>
    {{ form|fieldset:'#42945c' }}
</form>

Answer 6

这是我为了理解自定义标签（带有链接）而开发的代码。 我应用它来创建一个字段集。

免责声明：我鼓励使用上述任何答案，这只是为了学习。

templatetags/myextras.py：

from django import template
from django.template import Context

register = template.Library()


class FieldsetNode(template.Node):
    """ Fieldset renderer for 'fieldset' tag """
    def __init__(self, nodelist, fieldset_name):
        """ Initialize renderer class
        https://docs.djangoproject.com/en/1.8/howto/custom-template-tags/#writing-the-renderer
        :param nodelist: a list of the template nodes inside a block of 'fieldset'
        :param fieldset_name: the name of the fieldset
        :return: None
        """
        self.nodelist = nodelist
        self.fieldset_name = fieldset_name

    def render(self, context):
        """ Render the inside of a fieldset block based on template file
        https://docs.djangoproject.com/en/1.8/howto/custom-template-tags/#auto-escaping-considerations
        :param context: the previous template context
        :return: HTML string
        """
        t = context.template.engine.get_template('myapp/fieldset.html')
        return t.render(Context({
            'var': self.nodelist.render(context),
            'name': self.fieldset_name,
        }, autoescape=context.autoescape))


@register.tag
def fieldset(parser, token):
    """ Compilation function for fieldset block tag
    Render a form fieldset
    https://docs.djangoproject.com/en/1.8/howto/custom-template-tags/#writing-the-compilation-function
    https://docs.djangoproject.com/en/1.8/howto/custom-template-tags/#parsing-until-another-block-tag
    :param parser: template parser
    :param token: tag name and variables
    :return: HTML string
    """
    try:
        tag_name, fieldset_name = token.split_contents()
    except ValueError:
        raise template.TemplateSyntaxError("%r tag requires a single argument" % token.contents.split()[0])
    if not (fieldset_name[0] == fieldset_name[-1] and fieldset_name[0] in ('"', "'")):
        raise template.TemplateSyntaxError("%r tag's argument should be in quotes" % tag_name)
    nodelist = parser.parse(('endfieldset',))
    parser.delete_first_token()
    return FieldsetNode(nodelist, fieldset_name[1:-1])

templates/myapp/fieldset.html：

<div class="fieldset panel panel-default">
    <div class="panel-heading">{{ name }}</div>
    <div class="panel-body">{{ var }}</div>
</div>

templates/myapp/myform.html：

<form action="{% url 'myapp:myurl' %}" method="post">
    {% csrf_token %}
    {% fieldset 'General' %}
        {{form.myfield1 }}
    {% endfieldset %}
    {# my submit button #}
</form>