From 08de7a32d9a8eb790bfae52e1d9295e2436b03b3 Mon Sep 17 00:00:00 2001 From: Russell Keith-Magee Date: Mon, 10 May 2010 14:17:16 +0000 Subject: [PATCH] [1.1.X] Fixed #11908 -- Clarified the role and usage of the ManagementForm in formsets. Thanks to timo for the draft patch. Backport of r13222 from trunk. git-svn-id: http://code.djangoproject.com/svn/django/branches/releases/1.1.X@13227 bcc190cf-cafb-0310-a4f2-bffc1f526a37 --- docs/topics/forms/formsets.txt | 15 +++++++++++---- 1 file changed, 11 insertions(+), 4 deletions(-) diff --git a/docs/topics/forms/formsets.txt b/docs/topics/forms/formsets.txt index dc1c4fee32..801af02ebd 100644 --- a/docs/topics/forms/formsets.txt +++ b/docs/topics/forms/formsets.txt @@ -123,10 +123,12 @@ the expected error message appears for the second item. Understanding the ManagementForm ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -You may have noticed the additional data that was required in the formset's -data above. This data is coming from the ``ManagementForm``. This form is -dealt with internally to the formset. If you don't use it, it will result in -an exception:: +You may have noticed the additional data (``form-TOTAL_FORMS`` and +``form-INITIAL_FORMS``) that was required in the formset's data above. +This data is required for the ``ManagementForm``. This form is used by +the formset to manage the collection of forms contained in the +formset. If you don't provide this management data, an exception will +be raised:: >>> data = { ... 'form-0-title': u'Test', @@ -141,6 +143,11 @@ It is used to keep track of how many form instances are being displayed. If you are adding new forms via JavaScript, you should increment the count fields in this form as well. +The management form is available as an attribute of the formset +itself. When rendering a formset in a template, you can include all +the management data by rendering ``{{ my_formset.management_form }}`` +(substituting the name of your formset as appropriate). + .. versionadded:: 1.1 ``total_form_count`` and ``initial_form_count``