我知道您可以在 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 代码。
我认为这个片段正是你想要的。 它为您提供了一个 Form 子类,允许您以声明方式将表单细分为字段集并在模板中迭代它们。
更新:该片段已成为 django-form-utils
的一部分模型表单中的字段集仍处于“设计”阶段。 Django trac 中有一张ticket,活动量较低。
这是我在不久的将来有兴趣研究自己的事情,但由于我还没有这样做,所以我能提供的最好的就是这些片段:
编辑:我刚刚再次注意到这个问题,我意识到需要进行编辑以指出 Carl 的项目 django-form-utils,其中包含一个可以包含字段集的 BetterForm 类。 如果您喜欢这个项目,请为他的下面的答案+1 :)
您可以做的一件事是将逻辑字段集分解为单独的模型表单类。
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 表单的一个片段。
当您在表单上调用保存时,它会带来一定的复杂性。 您可能需要传递 commit=False ,然后合并生成的对象。 或者完全避免使用 ModelForm.save 并使用“cleaned_data”手动填充模型对象
Daniel Greenfelds django-uni-form 使用布局帮助器类解决了这个问题。我现在正在尝试,它对我来说看起来很干净。
我最初选择 Django-uni-form 因为它符合 section 508。
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>
这是我为了理解自定义标签(带有链接)而开发的代码。我应用它来创建一个字段集。
免责声明:我鼓励使用上述任何答案,这只是为了学习。
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>