Fixed #16965 -- Clarified Formset can_delete docs.
Thanks gregcorey@ for the suggestion.
This commit is contained in:
parent
1084575163
commit
660c30ed95
|
@ -413,7 +413,7 @@ happen when the user changes these values::
|
||||||
|
|
||||||
Default: ``False``
|
Default: ``False``
|
||||||
|
|
||||||
Lets you create a formset with the ability to delete::
|
Lets you create a formset with the ability to select forms for deletion::
|
||||||
|
|
||||||
>>> from django.forms.formsets import formset_factory
|
>>> from django.forms.formsets import formset_factory
|
||||||
>>> from myapp.forms import ArticleForm
|
>>> from myapp.forms import ArticleForm
|
||||||
|
@ -461,6 +461,13 @@ delete fields you can access them with ``deleted_forms``::
|
||||||
>>> [form.cleaned_data for form in formset.deleted_forms]
|
>>> [form.cleaned_data for form in formset.deleted_forms]
|
||||||
[{'DELETE': True, 'pub_date': datetime.date(2008, 5, 10), 'title': u'Article #1'}]
|
[{'DELETE': True, 'pub_date': datetime.date(2008, 5, 10), 'title': u'Article #1'}]
|
||||||
|
|
||||||
|
If you are using a :class:`ModelFormSet<django.forms.models.BaseModelFormSet>`,
|
||||||
|
model instances for deleted forms will be deleted when you call
|
||||||
|
``formset.save()``. On the other hand, if you are using a plain ``FormSet``,
|
||||||
|
it's up to you to handle ``formset.deleted_forms``, perhaps in your formset's
|
||||||
|
``save()`` method, as there's no general notion of what it means to delete a
|
||||||
|
form.
|
||||||
|
|
||||||
Adding additional fields to a formset
|
Adding additional fields to a formset
|
||||||
-------------------------------------
|
-------------------------------------
|
||||||
|
|
||||||
|
@ -559,8 +566,8 @@ If you manually render fields in the template, you can render
|
||||||
</form>
|
</form>
|
||||||
|
|
||||||
|
|
||||||
Similarly, if the formset has the ability to order (``can_order=True``), it is possible to render it
|
Similarly, if the formset has the ability to order (``can_order=True``), it is
|
||||||
with ``{{ form.ORDER }}``.
|
possible to render it with ``{{ form.ORDER }}``.
|
||||||
|
|
||||||
Using more than one formset in a view
|
Using more than one formset in a view
|
||||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||||
|
|
Loading…
Reference in New Issue