Controls whether a field is mandatory
on a form or if it can be left empty.
The
nullTest
property can be used for validations.
A
nullTest
validation is evaluated only as a result
of pre-event validation , such as preSubmit, prePrint, preSave,
or preExecute, depending on the value of
$config.present.validate
,
or an explicit scripting call to
execValidate
.
A container becomes invalid as the result of evaluating the first
validation test that fails. A container becomes valid if no validation
tests fail. A container is valid when no validation tests are evaluated
for that container. In that validation context,
nullTest
is
not evaluated and there is no other validation test.
For example, a field that is currently invalid because of a
nullTest
validation could
become valid as a result of a value being entered. Returning to
the field and entering an empty value does not cause the
nullTest
validation
to be executed automatically, so the field could become valid again.
A subsequent attempt to submit the form would cause the field to
become invalid again because of the
nullTest
.
If the
rawValue
for a field is null
or empty, the
nullTest
validation failed .
Syntax
Reference_Syntax.nullTest = "disabled | error | warning"
Values
|
Type
|
Values
|
|
String
|
-
disabled
(default)
-
error
-
warning
-
dismiss
: The user understands the form’s
recommendation and wishes to return to the form and satisfy this
constraint.
-
override
: The user understands the form’s
recommendation, but has chosen to contravene this constraint.
Do
not perform this test (default). The form object is permitted to
have a value of null. The field can be left without a value and
it will not negatively impact the validity of the form. This value
disables the validation test.
-
error
-
warning
-
dismiss
: The user understands the form’s
recommendation and wishes to return to the form and satisfy this
constraint.
-
override
: The user understands the form’s
recommendation, but has chosen to contravene this constraint.
Emit
an error message and refuse to accept an empty field. The form object
is required to have a non-null value.
-
warning
-
dismiss
: The user understands the form’s
recommendation and wishes to return to the form and satisfy this
constraint.
-
override
: The user understands the form’s
recommendation, but has chosen to contravene this constraint.
Emit
a warning message if the field is empty, but allow the user to proceed
to the next field. The message must inform the user that the form
object is recommended to have a value, and provide two choices:
-
dismiss
: The user understands the form’s
recommendation and wishes to return to the form and satisfy this
constraint.
-
override
: The user understands the form’s
recommendation, but has chosen to contravene this constraint.
|
JavaScript
TextField1.validate.nullTest = "error";
FormCalc
TextField1.validate.nullTest = "error"
