~ubuntu-branches/ubuntu/quantal/python-django/quantal-security

    ``BigIntegerField``              ``IntegerField`` with ``min_value`` set

                                     to -9223372036854775808 and ``max_value``

                                     set to 9223372036854775807.

 

.. versionadded:: 1.2

    The ``BigIntegerField`` is new in Django 1.2.

 

 

field. See `Overriding the default field types or widgets`_ below.

The ``is_valid()`` method and ``errors``

----------------------------------------

 

.. versionchanged:: 1.2

 

The first time you call ``is_valid()`` or access the ``errors`` attribute of a

``ModelForm`` has always triggered form validation, but as of Django 1.2, it

will also trigger :ref:`model validation <validating-objects>`. This has the

side-effect of cleaning the model you pass to the ``ModelForm`` constructor.

For instance, calling ``is_valid()`` on your form will convert any date fields

on your model to actual date objects.

 

 

Overriding the default field types or widgets

---------------------------------------------

 

.. versionadded:: 1.2

        The ``widgets`` attribute is new in Django 1.2.

``ModelForm`` gives you the flexibility of changing the form field type and

widget for a given model field.

 

To specify a custom widget for a field, use the ``widgets`` attribute of the

inner ``Meta`` class. This should be a dictionary mapping field names to widget

classes or instances.

 

For example, if you want the a ``CharField`` for the ``name``

attribute of ``Author`` to be represented by a ``<textarea>`` instead

of its default ``<input type="text">``, you can override the field's

widget::

 

    from django.forms import ModelForm, Textarea

 

    class AuthorForm(ModelForm):

        class Meta:

            model = Author

            fields = ['name', 'title', 'birth_date']

            widgets = {

                'name': Textarea(attrs={'cols': 80, 'rows': 20}),

            }

 

The ``widgets`` dictionary accepts either widget instances (e.g.,

``Textarea(...)``) or classes (e.g., ``Textarea``).

 

If you want to further customize a field -- including its type, label, etc. --

you can do this by declaratively specifying fields like you would in a regular

``Form``. Declared fields will override the default ones generated by using the

``model`` attribute.

    class ArticleForm(ModelForm):

        pub_date = MyDateFormField()

 

        class Meta:

            model = Article

 

If you want to override a field's default label, then specify the ``label``

   ...     pub_date = DateField(label='Publication date')

Interaction with model validation

---------------------------------

 

As part of its validation process, ``ModelForm`` will call the ``clean()``

method of each field on your model that has a corresponding field on your form.

If you have excluded any model fields, validation will not be run on those

fields. See the :ref:`form validation <ref-forms-validation>` documentation

for more on how field cleaning and validation work. Also, your model's

``clean()`` method will be called before any uniqueness checks are made. See

:ref:`Validating objects <validating-objects>` for more information on the

model's ``clean()`` hook.

 

    <input type="hidden" name="form-TOTAL_FORMS" value="1" id="id_form-TOTAL_FORMS" /><input type="hidden" name="form-INITIAL_FORMS" value="0" id="id_form-INITIAL_FORMS" /><input type="hidden" name="form-MAX_NUM_FORMS" id="id_form-MAX_NUM_FORMS" />

.. versionchanged:: 1.2

 

As with regular formsets, you can use the ``max_num`` and ``extra`` parameters

to ``modelformset_factory`` to limit the number of extra forms displayed.

 

``max_num`` does not prevent existing objects from being displayed::

    >>> AuthorFormSet = modelformset_factory(Author, max_num=1)

    >>> [x.name for x in formset.get_queryset()]

    [u'Charles Baudelaire', u'Paul Verlaine', u'Walt Whitman']

If the value of ``max_num`` is greater than the number of existing related

objects, up to ``extra`` additional blank forms will be added to the formset,

so long as the total number of forms does not exceed ``max_num``::

.. versionchanged:: 1.2

 

A ``max_num`` value of ``None`` (the default) puts no limit on the number of

forms displayed.

 

    <form method="post" action="">

    <form method="post" action="">

    <form method="post" action="">

    <form method="post" action="">