Livecycle

nullTest

Controls whether a field is mandatory on a form or if it can be left empty.

The nullTest property can be used for validations.

Syntax

Reference_Syntax.nullTest = “disabled | error | warning”

Values

 

Type

Values

String

• disabled (default) 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 Emit an error message and refuse to accept an empty field. The form object is required to have a non-null value. • warning 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.

Applies to

 

Model	Object
Form Model	validate

Version

XFA 2.1

Examples

JavaScript

TextField1.validate.nullTest =”error”;

FormCalc

TextField1.validate.nullTest =”error”

nullTest