mirror of
https://github.com/django/django.git
synced 2024-12-22 09:05:43 +00:00
Fixed up some omissions and one mysteriously documented, yet non-existent field
in the validator documentation. Patch from alang@bright-green.com. Refs #2266. git-svn-id: http://code.djangoproject.com/svn/django/trunk@5113 bcc190cf-cafb-0310-a4f2-bffc1f526a37
This commit is contained in:
parent
8a4a8023d6
commit
ec577d88ea
1
AUTHORS
1
AUTHORS
@ -42,6 +42,7 @@ people who have submitted patches, reported bugs, added translations, helped
|
||||
answer newbie questions, and generally made Django that much better:
|
||||
|
||||
adurdin@gmail.com
|
||||
alang@bright-green.com
|
||||
Daniel Alves Barbosa de Oliveira Vaz <danielvaz@gmail.com>
|
||||
Andreas
|
||||
andy@jadedplanet.net
|
||||
|
@ -517,7 +517,7 @@ to put punctuation at the end of your validation messages.
|
||||
When are validators called?
|
||||
---------------------------
|
||||
|
||||
After a form has been submitted, Django validates each field in turn. First,
|
||||
After a form has been submitted, Django validates each field in turn. First,
|
||||
if the field is required, Django checks that it is present and non-empty. Then,
|
||||
if that test passes *and the form submission contained data* for that field, all
|
||||
the validators for that field are called in turn. The emphasized portion in the
|
||||
@ -615,15 +615,19 @@ fails. If no message is passed in, a default message is used.
|
||||
``other_value``, then the validators in ``validator_list`` are all run
|
||||
against the current field.
|
||||
|
||||
``RequiredIfOtherFieldGiven``
|
||||
Takes a field name of the current field is only required if the other
|
||||
field has a value.
|
||||
|
||||
``RequiredIfOtherFieldsGiven``
|
||||
Similar to ``RequiredIfOtherFieldGiven``, except that it takes a list of
|
||||
field names and if any one of the supplied fields has a value provided,
|
||||
the current field being validated is required.
|
||||
|
||||
``RequiredIfOtherFieldNotGiven``
|
||||
Takes the name of the other field and this field is only required if the
|
||||
other field has no value.
|
||||
|
||||
``RequiredIfOtherFieldsNotGiven``
|
||||
Similar to ``RequiredIfOtherFieldNotGiven``, except that it takes a list
|
||||
of field names and if any one of the supplied fields does not have a value
|
||||
provided, the field being validated is required.
|
||||
|
||||
``RequiredIfOtherFieldEquals`` and ``RequiredIfOtherFieldDoesNotEqual``
|
||||
Each of these validator classes takes a field name and a value (in that
|
||||
order). If the given field does (or does not have, in the latter case) the
|
||||
@ -650,8 +654,8 @@ fails. If no message is passed in, a default message is used.
|
||||
``NumberIsInRange``
|
||||
Takes two boundary numbers, ``lower`` and ``upper``, and checks that the
|
||||
field is greater than ``lower`` (if given) and less than ``upper`` (if
|
||||
given).
|
||||
|
||||
given).
|
||||
|
||||
Both checks are inclusive. That is, ``NumberIsInRange(10, 20)`` will allow
|
||||
values of both 10 and 20. This validator only checks numeric values
|
||||
(e.g., float and integer values).
|
||||
|
Loading…
Reference in New Issue
Block a user