Proofread changes to docs/forms.txt from [3792]
git-svn-id: http://code.djangoproject.com/svn/django/trunk@3838 bcc190cf-cafb-0310-a4f2-bffc1f526a37
This commit is contained in:
parent
321a59a36a
commit
a0b78df2bb
|
@ -337,8 +337,8 @@ The only real differences are:
|
||||||
object being edited.
|
object being edited.
|
||||||
|
|
||||||
* We set ``new_data`` based upon ``flatten_data()`` from the manipulator.
|
* We set ``new_data`` based upon ``flatten_data()`` from the manipulator.
|
||||||
``flatten_data()`` takes the data from the original object under
|
``flatten_data()`` takes the data from the original object under
|
||||||
manipulation, and converts it into a data dictionary that can be used
|
manipulation, and converts it into a data dictionary that can be used
|
||||||
to populate form elements with the existing values for the object.
|
to populate form elements with the existing values for the object.
|
||||||
|
|
||||||
* The above example uses a different template, so create and edit can be
|
* The above example uses a different template, so create and edit can be
|
||||||
|
@ -404,7 +404,7 @@ Here's a simple function that might drive the above form::
|
||||||
errors = new_data = {}
|
errors = new_data = {}
|
||||||
form = forms.FormWrapper(manipulator, new_data, errors)
|
form = forms.FormWrapper(manipulator, new_data, errors)
|
||||||
return render_to_response('contact_form.html', {'form': form})
|
return render_to_response('contact_form.html', {'form': form})
|
||||||
|
|
||||||
``FileField`` and ``ImageField`` special cases
|
``FileField`` and ``ImageField`` special cases
|
||||||
==============================================
|
==============================================
|
||||||
|
|
||||||
|
@ -481,13 +481,13 @@ the data being validated.
|
||||||
Also, because consistency in user interfaces is important, we strongly urge you
|
Also, because consistency in user interfaces is important, we strongly urge you
|
||||||
to put punctuation at the end of your validation messages.
|
to put punctuation at the end of your validation messages.
|
||||||
|
|
||||||
When Are Validators Called?
|
When are validators called?
|
||||||
---------------------------
|
---------------------------
|
||||||
|
|
||||||
After a form has been submitted, Django first checks to see that all the
|
After a form has been submitted, Django first checks to see that all the
|
||||||
required fields are present and non-empty. For each field that passes that
|
required fields are present and non-empty. For each field that passes that
|
||||||
test *and if the form submission contained data* for that field, all the
|
test *and if the form submission contained data* for that field, all the
|
||||||
validators for that field are called in turn. The emphasised portion in the
|
validators for that field are called in turn. The emphasized portion in the
|
||||||
last sentence is important: if a form field is not submitted (because it
|
last sentence is important: if a form field is not submitted (because it
|
||||||
contains no data -- which is normal HTML behaviour), the validators are not
|
contains no data -- which is normal HTML behaviour), the validators are not
|
||||||
run against the field.
|
run against the field.
|
||||||
|
@ -497,13 +497,12 @@ This feature is particularly important for models using
|
||||||
``forms.CheckBoxField``. If the checkbox is not selected, it will not
|
``forms.CheckBoxField``. If the checkbox is not selected, it will not
|
||||||
contribute to the form submission.
|
contribute to the form submission.
|
||||||
|
|
||||||
If you would like your validator to *always* run, regardless of whether the
|
If you would like your validator to run *always*, regardless of whether its
|
||||||
field it is attached to contains any data, set the ``always_test`` attribute
|
attached field contains any data, set the ``always_test`` attribute on the
|
||||||
on the validator function. For example::
|
validator function. For example::
|
||||||
|
|
||||||
def my_custom_validator(field_data, all_data):
|
def my_custom_validator(field_data, all_data):
|
||||||
# ...
|
# ...
|
||||||
|
|
||||||
my_custom_validator.always_test = True
|
my_custom_validator.always_test = True
|
||||||
|
|
||||||
This validator will always be executed for any field it is attached to.
|
This validator will always be executed for any field it is attached to.
|
||||||
|
|
Loading…
Reference in New Issue