diff options
| author | Bryan Marty <bryanmarty@gmail.com> | 2015-10-27 18:37:35 -0700 |
|---|---|---|
| committer | Tim Graham <timograham@gmail.com> | 2015-10-28 15:46:45 -0400 |
| commit | 44f177b5cdab82ffefa81abd3e9c2a13aaab256f (patch) | |
| tree | ce72d8da48851b69948d0295cd4b80b0bb197075 /docs/topics/forms/modelforms.txt | |
| parent | 46850e2c850b50279c946b4078601f2b41ef7554 (diff) | |
[1.9.x] Fixed #21516 -- Updated imports paths for some formset functions/classes.
Since refs #21489, FormSet classes and factories are exposed on the
django.forms package.
Backport of 455034d4df048010de4ae0a9a2392b70d1463c61 from master
Diffstat (limited to 'docs/topics/forms/modelforms.txt')
| -rw-r--r-- | docs/topics/forms/modelforms.txt | 20 |
1 files changed, 10 insertions, 10 deletions
diff --git a/docs/topics/forms/modelforms.txt b/docs/topics/forms/modelforms.txt index e9898c6fff..882478fc2a 100644 --- a/docs/topics/forms/modelforms.txt +++ b/docs/topics/forms/modelforms.txt @@ -704,7 +704,7 @@ You can create forms from a given model using the standalone function definition. This may be more convenient if you do not have many customizations to make:: - >>> from django.forms.models import modelform_factory + >>> from django.forms import modelform_factory >>> from myapp.models import Book >>> BookForm = modelform_factory(Book, fields=("author", "title")) @@ -735,7 +735,7 @@ Like :doc:`regular formsets </topics/forms/formsets>`, Django provides a couple of enhanced formset classes that make it easy to work with Django models. Let's reuse the ``Author`` model from above:: - >>> from django.forms.models import modelformset_factory + >>> from django.forms import modelformset_factory >>> from myapp.models import Author >>> AuthorFormSet = modelformset_factory(Author, fields=('name', 'title')) @@ -785,7 +785,7 @@ queryset that includes all objects in the model (e.g., Alternatively, you can create a subclass that sets ``self.queryset`` in ``__init__``:: - from django.forms.models import BaseModelFormSet + from django.forms import BaseModelFormSet from myapp.models import Author class BaseAuthorFormSet(BaseModelFormSet): @@ -953,7 +953,7 @@ Using a model formset in a view Model formsets are very similar to formsets. Let's say we want to present a formset to edit ``Author`` model instances:: - from django.forms.models import modelformset_factory + from django.forms import modelformset_factory from django.shortcuts import render_to_response from myapp.models import Author @@ -987,7 +987,7 @@ the unique constraints on your model (either ``unique``, ``unique_together`` or on a ``ModelFormSet`` and maintain this validation, you must call the parent class's ``clean`` method:: - from django.forms.models import BaseModelFormSet + from django.forms import BaseModelFormSet class MyModelFormSet(BaseModelFormSet): def clean(self): @@ -1003,7 +1003,7 @@ have already been created for each ``Form``. Modifying a value in to modify a value in ``ModelFormSet.clean()`` you must modify ``form.instance``:: - from django.forms.models import BaseModelFormSet + from django.forms import BaseModelFormSet class MyModelFormSet(BaseModelFormSet): def clean(self): @@ -1021,7 +1021,7 @@ Using a custom queryset As stated earlier, you can override the default queryset used by the model formset:: - from django.forms.models import modelformset_factory + from django.forms import modelformset_factory from django.shortcuts import render_to_response from myapp.models import Author @@ -1125,7 +1125,7 @@ you have these two models:: If you want to create a formset that allows you to edit books belonging to a particular author, you could do this:: - >>> from django.forms.models import inlineformset_factory + >>> from django.forms import inlineformset_factory >>> BookFormSet = inlineformset_factory(Author, Book, fields=('title',)) >>> author = Author.objects.get(name='Mike Royko') >>> formset = BookFormSet(instance=author) @@ -1149,7 +1149,7 @@ When overriding methods on ``InlineFormSet``, you should subclass For example, if you want to override ``clean()``:: - from django.forms.models import BaseInlineFormSet + from django.forms import BaseInlineFormSet class CustomInlineFormSet(BaseInlineFormSet): def clean(self): @@ -1164,7 +1164,7 @@ See also :ref:`model-formsets-overriding-clean`. Then when you create your inline formset, pass in the optional argument ``formset``:: - >>> from django.forms.models import inlineformset_factory + >>> from django.forms import inlineformset_factory >>> BookFormSet = inlineformset_factory(Author, Book, fields=('title',), ... formset=CustomInlineFormSet) >>> author = Author.objects.get(name='Mike Royko') |
