django-superform 0.3.1

django-superform

不那么糟糕的表单集。

如果您想在多个表单之间嵌套，则“SuperForm”绝对非常出色。在SuperForm中使用表单集和嵌套表单。SuperForm将负责其子表单！

想象一下，您想要一个视图来显示和验证一个表单和一个表单集。让我们假设您有一个注册表单，用户可以输入多个电子邮件地址。Django为此用例提供了表单集，但在视图中处理这些通常相当麻烦。您需要手动验证表单和表单集，并且不能使用Django的通用FormView。因此，django-superform就派上用场了。

这里有一个用例的示例。让我们看一下forms.py

from django import forms
from django_superform import SuperModelForm, InlineFormSetField
from myapp.models import Account, Email


class EmailForm(forms.ModelForm):
    class Meta:
        model = Email
        fields = ('account', 'email',)


EmailFormSet = modelformset_factory(EmailForm)


class SignupForm(SuperModelForm):
    username = forms.CharField()
    # The model `Email` has a ForeignKey called `user` to `Account`.
    emails = InlineFormSetField(formset_class=EmailFormSet)

    class Meta:
        model = Account
        fields = ('username',)

因此，我们将EmailFormSet直接分配给SignupForm字段。这就是它的位置！那么如何在视图中处理这个组合表单？请看以下内容

def post_form(request):
    if request.method == 'POST':
        form = PostForm(request.POST)
        if form.is_valid():
            account = form.save()
            return HttpResponseRedirect('/success/')
    else:
        form = PostForm()
    return render_to_response('post_form.html', {
        'form',
    }, context_instance=RequestContext(request))

不，我们并没有在拥有 FormSet 的 SignupForm 上做任何不同的事情。这样你可以自由地在表单本身实现所有逻辑，并使用像 CreateView 这样的通用视图，就像你使用简单表单时一样。想看一个例子吗？

from django.views.generic import CreateView
from myapp.models import Account
from myapp.forms import SignupForm


class SignupView(CreateView):
    model = Account
    form_class = SignupForm


urlpatterns = patterns('',
    url('^signup/$', SignupView.as_view()),
)

它只需这样做。

变更日志