Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Browse files

Fixed #11755 -- Added documentation for an edge case of FormSet usage…

…. Thanks to ffualo for the suggestion.

git-svn-id: http://code.djangoproject.com/svn/django/trunk@11549 bcc190cf-cafb-0310-a4f2-bffc1f526a37
  • Loading branch information...
commit f8077919b5b4c13f15a2e47a7fb657ac81685302 1 parent 38e78da
@freakboy3742 freakboy3742 authored
Showing with 11 additions and 5 deletions.
  1. +11 −5 docs/topics/forms/modelforms.txt
View
16 docs/topics/forms/modelforms.txt
@@ -374,24 +374,24 @@ parameter when declaring the form field::
.. note::
If you explicitly instantiate a form field like this, Django assumes that you
- want to completely define its behavior; therefore, default attributes (such as
- ``max_length`` or ``required``) are not drawn from the corresponding model. If
+ want to completely define its behavior; therefore, default attributes (such as
+ ``max_length`` or ``required``) are not drawn from the corresponding model. If
you want to maintain the behavior specified in the model, you must set the
relevant arguments explicitly when declaring the form field.
For example, if the ``Article`` model looks like this::
class Article(models.Model):
- headline = models.CharField(max_length=200, null=True, blank=True,
+ headline = models.CharField(max_length=200, null=True, blank=True,
help_text="Use puns liberally")
content = models.TextField()
and you want to do some custom validation for ``headline``, while keeping
- the ``blank`` and ``help_text`` values as specified, you might define
+ the ``blank`` and ``help_text`` values as specified, you might define
``ArticleForm`` like this::
class ArticleForm(ModelForm):
- headline = MyFormField(max_length=200, required=False,
+ headline = MyFormField(max_length=200, required=False,
help_text="Use puns liberally")
class Meta:
@@ -541,6 +541,12 @@ Then, pass your ``BaseAuthorFormSet`` class to the factory function::
>>> AuthorFormSet = modelformset_factory(Author, formset=BaseAuthorFormSet)
+If you want to return a formset that doesn't include *any* pre-existing
+instances of the model, you can specify an empty QuerySet::
+
+ >>> AuthorFormSet(queryset=Author.objects.none())
+
+
Controlling which fields are used with ``fields`` and ``exclude``
-----------------------------------------------------------------
Please sign in to comment.
Something went wrong with that request. Please try again.